Skip to content
BranchesTags
 
 

Repository files navigation

Tiny11 Automated Builder

Build Tiny11 Build Tiny11 Core Build Nano11 SourceForge Downloads License

Sponsor Buy Me a Coffee

Code of Conduct

Automated tools for creating streamlined Windows 11 images with CI/CD support.

📊 Project Stats

  • 📦 Total Downloads: 205391 (and growing!)
  • 🌍 Active Users: 205391 worldwide
  • ✅ Build Success Rate: 100%
  • ⏱️ Average Build Time: ~30-50 minutes
  • 💾 ISO Size Reduction: Up to 50% smaller (Windows 11 25H2)

🆕 What's New (January 2026)

Windows 11 25H2 Optimizations:

  • ✨ AI/Recall Removal: Complete removal of Copilot, Recall, and AI Fabric (~220 MB saved)
  • 🛡️ Enhanced Telemetry Blocking: Stronger privacy protection with additional registry tweaks
  • 🎮 VRAM Gaming Optimization: Improved graphics performance through DirectX registry optimizations
  • ⚡ Build-Specific Service Removal: 4 services (Standard), 13 services (Core), 14 services (Nano)
  • 🚫 Windows Update Binary Removal: Core/Nano builds now remove WU binaries (~300 MB saved)

Total Additional Savings:

  • Standard: ~120 MB
  • Core: ~320 MB
  • Nano: ~320 MB

📋 Overview

Tiny11 Automated Builder provides production-ready PowerShell scripts to create minimized Windows 11 ISO images by:

✨ Removing bloatware (40+ unnecessary apps)
🔒 Disabling telemetry (complete privacy protection)
⚡ Optimizing performance (faster boot, less resource usage)
🤖 Full CI/CD automation (GitHub Actions workflows)
🛠️ System requirement bypass (TPM, CPU, RAM checks removed)

Three variants available: Standard (daily use), Core (ultra-minimal), Nano (VM testing)

🙏 Attribution

This project is based on the original tiny11 builder by ntdevlabs. The headless versions were created by kelexine to enable automated CI/CD builds while preserving all original functionality.

📥 Downloads

Download Tiny 11 Releases

⚠️ ISO files are hosted on SourceForge only. GitHub Releases contains release notes and checksums.

🌐 Landing Pages

⚖️ Legal Notice

IMPORTANT: These scripts are for educational and testing purposes only. You must have a valid Windows license. Using modified Windows images may violate Microsoft's terms of service. See LICENSE and SECURITY.md for details.

🚀 Quick Start

Option 1: Automated Build (GitHub Actions) - Recommended

Perfect for beginners and automated deployments:

  1. Fork this repository
  2. Go to Actions tab
  3. Choose your workflow:
    • Build Tiny11 → Standard trimmed Windows 11
    • Build Tiny11 Core → Ultra-minimal variant
    • Build Nano11 → EXTREME minimal (VM only)
  4. Click "Run workflow" and configure:
    • Windows ISO URL
    • Edition (Home/Pro/Education)
    • Optional parameters
  5. Download ISO from Artifacts or SourceForge

Build time: 30-80 minutes depending on variant

Option 2: Manual Build (PowerShell)

For advanced users and local builds:

# 1. Download or mount Windows 11 ISO
# 2. Note the drive letter (e.g., E:)
# 3. Run PowerShell as Administrator
# 4. Set execution policy
Set-ExecutionPolicy Bypass -Scope Process

# 5. Choose your variant:

# Standard Tiny11 (Recommended for daily use)
.\scripts\tiny11maker-headless.ps1 -ISO E -INDEX 1

# Tiny11 Core (Ultra-minimal, VM/testing only)
.\scripts\tiny11coremaker-headless.ps1 -ISO E -INDEX 6

# Nano11 (EXTREME minimal, VM testing ONLY)
.\scripts\nano11builder-headless.ps1 -ISO E -INDEX 1

# With .NET 3.5 (Core variant only)
.\scripts\tiny11coremaker-headless.ps1 -ISO E -INDEX 1 -ENABLE_DOTNET35

System Requirements: Windows 10/11, PowerShell 5.1+, 30GB+ free space, Admin rights

⚠️ Choose Your Variant

Feature 🟢 Standard 🟡 Core 🔴 Nano
Use Case Daily use (with caution) Testing, disposable VMs VM testing ONLY
ISO Size ~3.5-5.5GB ~3-3.5GB ~2.5GB
Bloatware Removal ✅ 40+ apps ✅ 40+ apps ✅ 50+ apps
Telemetry Disabled ✅ Complete ✅ Complete ✅ Complete
WinSxS Component Store ✅ Full ❌ Minimized ❌ Minimized
Windows Recovery ✅ Intact ⚙️ Optional (removed by default, use -PreserveWinRE) ⚙️ Optional (removed by default, use -PreserveWinRE)
Windows Defender ✅ Included ❌ Disabled ❌ Removed
Serviceability ✅ Can add features/updates ❌ Cannot service ❌ Cannot service
Printing Support ✅ Yes ✅ Yes ❌ No
Basic Apps (Notepad, Paint) ✅ Included ✅ Included ❌ Removed
Build Time 45-80 min 30-45 min <40 min

💡 Which Should You Choose?

  • 🟢 Standard: Best for most users. Balanced bloat removal with system stability
  • 🟡 Core: Perfect for development VMs, testing environments, disposable systems
  • 🔴 Nano: Absolute minimal testing only. Expect broken features. VM use ONLY.

📁 Repository Structure

tiny11-automated/
├── .github/
│   ├── workflows/              # GitHub Actions CI/CD
│   │   ├── build-tiny11.yml
│   │   ├── build-tiny11-core.yml
│   │   └── build-nano11.yml
│   ├── ISSUE_TEMPLATE/         # Issue templates
│   └── PULL_REQUEST_TEMPLATE.md
├── scripts/
│   ├── tiny11maker-headless.ps1          # ✨ Automated Standard
│   ├── tiny11coremaker-headless.ps1      # ✨ Automated Core
│   └── nano11builder-headless.ps1        # ✨ Automated Nano
├── autounattend.xml            # OOBE bypass (Standard/Core)
├── autounattend-nano.xml       # OOBE bypass (Nano)
├── CONTRIBUTING.md             # Contributor guidelines
├── CODE_OF_CONDUCT.md          # Community standards
├── SECURITY.md                 # Security policy
├── ROADMAP.md                  # Project roadmap
├── README.md                   # This file
└── LICENSE                     # MIT License

🔧 Script Parameters

Standard & Core Variants

.\tiny11maker-headless.ps1
    -ISO <string>              # Drive letter of mounted ISO (e.g., "E")
    -INDEX <int>               # Image index (1=Home, 4=Education, 6=Pro, 7=Pro N)
    [-SCRATCH <string>]        # Optional: Scratch disk (default: script directory)
    [-SkipCleanup]             # Optional: Keep temp files for debugging

Core-Only Parameter

.\tiny11coremaker-headless.ps1
    [-ENABLE_DOTNET35]         # Enable .NET Framework 3.5 support
    [-PreserveWinRE]           # Keep winre.wim intact (required for real hardware / 24H2+ to avoid 0x8007000B)

Nano Variant

.\nano11builder-headless.ps1
    -ISO <string>              # Drive letter of mounted ISO
    -INDEX <int>               # Image index
    [-SCRATCH <string>]        # Optional: Scratch disk
    [-SkipCleanup]             # Optional: Keep temp files
    [-PreserveWinRE]           # Keep winre.wim intact (required for real hardware / 24H2+ to avoid 0x8007000B)

Examples

# Basic build - Windows 11 Home Standard
.\scripts\tiny11maker-headless.ps1 -ISO E -INDEX 1

# Professional Edition Core with .NET 3.5
.\scripts\tiny11coremaker-headless.ps1 -ISO E -INDEX 6 -ENABLE_DOTNET35

# Core build targeting real hardware (preserves WinRE to avoid 0x8007000B on 24H2/25H2)
.\scripts\tiny11coremaker-headless.ps1 -ISO E -INDEX 6 -PreserveWinRE

# Nano build with WinRE preserved (real hardware use)
.\scripts\nano11builder-headless.ps1 -ISO E -INDEX 1 -PreserveWinRE

# Custom scratch drive (useful for limited C:\ space)
.\scripts\tiny11maker-headless.ps1 -ISO E -INDEX 1 -SCRATCH D

# Debug mode (keeps temporary files)
.\scripts\tiny11maker-headless.ps1 -ISO E -INDEX 1 -SkipCleanup

📦 What Gets Removed?

🗑️ Bloatware Apps (40-50+ removed)

Click to expand full list

Productivity & Entertainment:

  • Microsoft Teams
  • OneDrive
  • Microsoft Edge
  • Xbox Game Bar & Gaming Services
  • Clipchamp Video Editor
  • Paint 3D
  • 3D Viewer
  • Mixed Reality Portal

Information & News:

  • Weather
  • News
  • Maps
  • Bing Search

Communication:

  • Skype
  • Cortana
  • People App
  • Your Phone (Phone Link)
  • Outlook for Windows (new)

AI Features (Windows 11 25H2+):

  • Windows Copilot (AI Assistant)
  • Windows Recall (AI Snapshots)
  • AI Fabric Service
  • CoreAI Components

Office & Productivity:

  • Office Hub
  • Power Automate
  • Solitaire Collection
  • Sticky Notes
  • To Do

Utilities:

  • Get Help
  • Get Started (Tips)
  • Feedback Hub
  • Quick Assist
  • DevHome

Media:

  • Media Player
  • Sound Recorder
  • Photos
  • Camera (Nano only)

Additional (Nano only):

  • Notepad
  • Paint
  • Windows Terminal

🔧 System Components Removed

  • Internet Explorer (legacy package)
  • Windows Media Player (legacy)
  • WordPad
  • Math Input Panel
  • Steps Recorder
  • LA57 CPU compatibility layer
  • Language features (OCR, Speech, Handwriting)
  • Windows Defender (Core/Nano only)
  • Printer drivers (Nano only)
  • Scanner/MFD drivers (Nano only)

⚙️ Registry Optimizations Applied

Click to expand optimizations

System Requirements:

  • TPM 2.0 requirement bypass
  • Secure Boot requirement bypass
  • CPU compatibility check bypass
  • RAM requirement bypass (allows <4GB)

Privacy & Telemetry:

  • All telemetry endpoints disabled
  • Enhanced diagnostic data blocking
  • Activity history disabled
  • Location services disabled
  • Advertising ID disabled
  • Device name excluded from telemetry
  • Feedback notifications disabled

AI & Privacy (NEW - Windows 11 25H2):

  • Windows AI data analysis completely disabled
  • Copilot AI assistant fully removed
  • Recall snapshot feature blocked
  • AI Fabric service disabled

User Experience:

  • Sponsored apps blocked
  • Consumer features disabled
  • Reserved storage disabled
  • BitLocker encryption disabled
  • Windows Search indexing optimized
  • Chat icon removed from taskbar
  • Widgets disabled
  • Cortana startup disabled

Performance (NEW):

  • VRAM allocation optimized for gaming
  • Non-essential services disabled (4-13 depending on variant)
  • Diagnostic services removed
  • Telemetry services disabled

Update & Cloud:

  • Windows Update disabled (can be manually enabled in Standard)
  • Windows Update binaries removed (Core/Nano - NON-SERVICEABLE)
  • OneDrive backup prompts disabled
  • Teams auto-install blocked
  • New Outlook installation blocked

💾 System Requirements

For Building ISOs

Requirement Minimum Recommended
Operating System Windows 10 Windows 11
PowerShell 5.1 7.0+
RAM 8GB 16GB+
Free Disk Space 20GB 40GB+
Processor Dual-core Quad-core+
Permissions Administrator Administrator
Network For oscdimg.exe download Stable connection

Additional Requirements:

  • Windows ADK (optional, oscdimg.exe auto-downloaded if missing)
  • Valid Windows 11 ISO file
  • Antivirus temporarily disabled (optional, may interfere)

For Running Built ISOs

✅ System requirements are bypassed! Tiny11 can run on:

  • CPU: Any x64/ARM64 processor (Pentium, Core 2 Duo, etc.)
  • RAM: 1GB minimum (2GB+ recommended)
  • Storage: 10GB minimum (20GB+ recommended)
  • TPM: Not required (completely bypassed)
  • Secure Boot: Not required (bypassed)
  • UEFI/BIOS: Both supported

✨ Perfect for:

  • Old laptops (2010+)
  • Low-spec hardware
  • Virtual machines
  • Testing environments
  • Educational purposes

🏗️ GitHub Actions Workflows

Automated Builds via CI/CD

All three variants support automated building through GitHub Actions:

1. Build Tiny11 (Standard)

File: .github/workflows/build-tiny11.yml

Inputs:

windows_iso_url:        # Windows 11 ISO download URL
  required: true
  
image_index:            # Windows edition
  type: choice
  options: [1, 4, 6, 7]  # Home, Education, Pro, Pro N
  
skip_cleanup:           # Debug mode (keep artifacts)
  type: boolean
  default: false

2. Build Tiny11 Core (Ultra-Minimal)

File: .github/workflows/build-tiny11-core.yml

Inputs:

windows_iso_url:        # Same as Standard
image_index:            # Same as Standard
skip_cleanup:           # Same as Standard
enable_dotnet35:        # 🆕 Enable .NET Framework 3.5
  type: boolean
  default: false
preserve_winre:         # 🆕 Preserve winre.wim (real hardware / 24H2+ builds)
  type: boolean
  default: false

3. Build Nano11 (EXTREME Minimal)

File: .github/workflows/build-nano11.yml

Inputs:

windows_version:        # Version string (24H2, 25H2, etc.)
  required: true
  
windows_iso_url:        # Same as above
image_index:            # Same as above
language:               # Language name (English, etc.)
  default: "English"
  
skip_cleanup:           # Same as above
preserve_winre:         # 🆕 Preserve winre.wim (real hardware / 24H2+ builds)
  type: boolean
  default: false

Workflow Features

✨ Automated download - Fetches ISO automatically
🔐 Checksum verification - Validates ISO integrity
📢 Discord notifications - Real-time build status
📦 Artifact upload - ISO + checksums available
🚀 SourceForge deployment - Automatic release distribution
📊 Build statistics - Performance metrics tracked

📊 Build Performance

Variant Download Time Build Time Total Time Output Size
Standard 5-15 min 45-80 min 50-95 min ~4-5GB
Core 5-15 min 30-45 min 35-60 min ~3-4GB
Nano 5-15 min <40 min ~45-55 min ~2-2.9GB

Build times measured on GitHub Actions standard runners (2-core, 7GB RAM)

Factors affecting build time:

  • ISO download speed
  • Number of apps to remove (more apps = longer compression)
  • WinSxS optimization (Core/Nano)
  • Runner performance
  • Concurrent builds

🐛 Troubleshooting

Common Issues & Solutions

"Script must run as Administrator"

Problem: PowerShell not running with elevated privileges

Solutions:

  1. Right-click PowerShell → "Run as Administrator"
  2. Let script auto-elevate (it will restart automatically)
  3. In VS Code: Run as admin before opening
"Insufficient disk space"

Problem: Not enough free space on C:\ drive

Solutions:

  1. Free up at least 30GB on C:\
  2. Use -SCRATCH parameter to specify different drive: 
    .\tiny11maker-headless.ps1 -ISO E -INDEX 1 -SCRATCH D
  3. Clean Windows temp files: cleanmgr
  4. Check disk space: Get-PSDrive C
"ISO creation fails" / "oscdimg.exe error"

Problem: Missing oscdimg.exe or corrupted installation

Solutions:

  1. Install Windows ADK:
  2. Let script download oscdimg.exe automatically (requires internet)
  3. Verify antivirus isn't blocking the script
  4. Check file permissions on script directory
"Build failures in GitHub Actions"

Problem: Workflow fails during automated build

Solutions:

  1. Check workflow logs for specific error
  2. Enable skip_cleanup: true to preserve artifacts
  3. Verify ISO URL is accessible and correct
  4. Check if SourceForge credentials are configured (for upload)
  5. Ensure GitHub Actions has sufficient runner space

Common causes:

  • Invalid ISO URL (404 error)
  • Network timeout during download
  • Insufficient runner disk space
  • SourceForge API rate limiting
"ISO boots but shows errors"

Problem: Generated ISO boots but has missing features

Solutions:

  1. Verify you used the correct variant:
    • Standard: Most features intact
    • Core: Some features unavailable
    • Nano: Many features broken (expected)
  2. Check if you need .NET 3.5 (Core only): 
    -ENABLE_DOTNET35
  3. For printing issues: Don't use Nano variant
  4. For Windows Defender: Use Standard variant
  5. Rebuild with Standard variant if Core/Nano too aggressive
"Checksums don't match"

Problem: Downloaded ISO checksum verification fails

Solutions:

  1. Re-download ISO from official source
  2. Verify download completed fully (check file size)
  3. Scan for disk errors: chkdsk /f
  4. Try different download mirror
  5. Compare with official checksums from Microsoft

Verify checksum:

Get-FileHash -Path "tiny11.iso" -Algorithm SHA256

🔐 Security Considerations

⚠️ Important Security Information

Before using Tiny11:

  1. Modified Windows Images → May have security implications

    • No official Microsoft support
    • Potential compatibility issues
    • Use at your own risk

  2. Windows Defender Removed (Core/Nano)

    • Install third-party antivirus (Avast, Kaspersky, etc.)
    • Keep antivirus updated
    • Consider using Standard variant for better security

  3. Updates Disabled by Default

    • Manually enable if needed: services.msc → Windows Update
    • No automatic security patches
    • Monitor security advisories manually

  4. Privacy vs. Functionality Trade-off

    • Telemetry disabled → Better privacy
    • Some features may not work without telemetry
    • Cloud features limited/disabled

  5. Production Use NOT Recommended

    • Use for testing/development only
    • Not suitable for business-critical systems
    • Consider official Windows for production

🔒 Security Best Practices

✅ Download from official sources only

✅ Verify checksums before installation

Get-FileHash -Path "tiny11.iso" -Algorithm SHA256
# Compare with official checksum

✅ Test in VM before bare-metal installation

  • Use VirtualBox, Hyper-V, or VMware
  • Verify functionality meets your needs
  • Check for compatibility issues

✅ Backup important data before installing

  • Full system backup recommended
  • Document current configuration
  • Have recovery media ready

✅ Use valid Windows license

  • Tiny11 is NOT a Windows activator
  • Legal Windows license required
  • Respect Microsoft's terms of service

🚨 Vulnerability Reporting

Found a security issue? DO NOT create a public GitHub issue!

📧 Email: frankiekelechi@gmail.com
🔒 Subject: [SECURITY] Tiny11 Vulnerability Report
📋 See: SECURITY.md for full disclosure policy

📖 Documentation

📚 Available Documentation

🎓 Tutorials & Guides

  • Windows Edition Index Numbers:

    • 1 = Windows 11 Home
    • 4 = Windows 11 Education
    • 6 = Windows 11 Pro
    • 7 = Windows 11 Pro N (without media features)

  • Finding Edition Index:

    # Mount ISO first, then:
dism /Get-WimInfo /WimFile:E:\sources\install.wim

  • Manual OOBE Bypass: Edit autounattend.xml for custom configurations

🤝 Contributing

We welcome contributions from the community! Tiny11 Automated serves 2,000+ users worldwide.

Ways to Contribute

  • 🐛 Report bugs
  • ✨ Request features
  • 📝 Improve documentation
  • 🧪 Test new builds
  • 💻 Submit pull requests
  • 🌍 Translate documentation
  • ⭐ Star the repository

Contribution Guidelines

  1. Read CONTRIBUTING.md
  2. Fork the repository
  3. Create a feature branch (git checkout -b feature/amazing-feature)
  4. Test your changes locally (see testing section below)
  5. Commit with clear messages (git commit -m 'feat: add amazing feature')
  6. Push to your fork (git push origin feature/amazing-feature)
  7. Open a Pull Request

🧪 Scraper Unit Testing

For Python automation components (such as scripts/microsoft_direct_downloader.py), a robust unit and integration test suite is located in the tests/ directory.

To run the test suite in an isolated environment:

# 1. Set up a local virtual environment
python3 -m venv .venv
source .venv/bin/activate

# 2. Install dependencies & test requirements
pip install -r requirements.txt pytest pytest-asyncio

# 3. Execute the test suite
pytest tests/test_microsoft_downloader.py

This test suite uses complete mock coverage of Playwright page locators and user-agent rotations to validate scraper behavior without performing live requests.

Contributor Recognition

All contributors are recognized in:

  • Release notes
  • CONTRIBUTORS.md file
  • Project README
  • Special Discord role (if applicable)

By contributing, you agree to our Code of Conduct and MIT License.

💬 Community

Connect With Us

  • 💬 Discord: Join our server - Real-time chat & support
  • 🗨️ GitHub Discussions: Ask questions - Q&A and ideas
  • 🐛 Issue Tracker: Report bugs - Bug reports only
  • 📥 SourceForge: Download releases - Official ISOs
  • 🔔 Release Notifications: Watch repository → Custom → Releases

Community Stats

  • 👥 Active Users: 3,000+
  • 📥 Total Downloads: 19,000+
  • 📈 Weekly Downloads: 3,000 (growing!)
  • ⭐ GitHub Stars: 11
  • 🍴 Forks: 8

Get Help

  1. Read the docs - Check README and wiki first
  2. Search issues - Someone may have asked before
  3. Ask in Discord - Fastest real-time help
  4. Create discussion - For general questions
  5. File issue - For confirmed bugs only

📝 License

Licensing Information

  • Tiny11 Automated (headless scripts, CI/CD): MIT License © 2025 kelexine
  • Inspired by tiny11builder: Original concept and interactive scripts by ntdevlabs, MIT License — the headless automation in this project was built on top of that foundation
  • Individual files: See copyright notices in each file

MIT License Summary

✅ Permitted:

  • Commercial use
  • Modification
  • Distribution
  • Private use

❌ Limitations:

  • No warranty
  • No liability

📋 Conditions:

  • License and copyright notice must be included
  • Proper attribution required

Full license: LICENSE

⚖️ Disclaimer

Legal Disclaimer

This tool is provided "as is" without warranty of any kind, express or implied.

The authors (kelexine, ntdevlabs) are NOT responsible for:

❌ System damage from using modified Windows images
❌ Data loss or corruption
❌ Violation of Microsoft's terms of service
❌ Legal issues from improper use
❌ Compatibility problems
❌ Security vulnerabilities
❌ Performance issues

Your Responsibilities

✅ You must have a valid Windows license
✅ You must understand the risks
✅ You must backup your data
✅ You must comply with applicable laws
✅ You must use responsibly and ethically

Use at your own risk. See LICENSE and SECURITY.md for details.

🔗 Important Links

Official Resources

Related Projects

Author

🙏 Acknowledgments

Special Thanks

  • ntdevlabs - Creator of original tiny11builder
  • Microsoft - Windows 11 operating system
  • Community contributors - Bug reports, feature requests, and PRs
  • 2,000+ users worldwide - Your feedback drives improvement

Support the Project

If Tiny11 Automated has helped you:

  • ⭐ Star the repository - Show your support
  • 🍴 Fork and contribute - Help improve it
  • 📢 Share with others - Spread the word
  • 💖 Sponsor development - Fund new features (optional)

About

Automated tools for creating streamlined Windows 11 images with CI/CD support. Builds Tiny11 and Tiny11 Core ISOs with GitHub Actions workflows.

Resources

Readme

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages