An offline Windows 11 rescue and setup toolkit for technicians. Debloat, driver installation, and external-monitor recovery — run either inside a live Windows install or from a WinPE rescue USB. No network. No telemetry. No bundled Microsoft binaries.
-lightgrey){kind=icon}
Rakuyo is source-available for audit and evaluation, not open source. See License. This is a solo, unfinished project currently in closed beta. There is no prebuilt ISO or signed installer yet — you build it yourself from this source. That is by design; see Why there is no ISO.
There is no published release or binary at this time. During closed beta, Rakuyo is distributed as source only — you clone/download this repository and build it locally. See Build and Why the source is public.
If you are a beta tester, start with docs/BETA_TESTER_README.md.
Rakuyo focuses on a small set of jobs that come up when refurbishing or rescuing an aging notebook:
- Debloat — removes preinstalled Appx packages according to an explicit preset, guarded by a protection whitelist so system-critical packages are never touched.
- Drivers — installs your own signed
.infdriver packages onto unknown/uninstalled devices using Windows' standardpnputil. Rakuyo ships no drivers; you place signed INF packages inDrivers/yourself. - Monitor recovery — forces external display output on a machine whose internal panel is dead, so it can still be used or serviced.
- A laptop that boots but is buried under OEM bloat and won't behave.
- A fresh or reimaged machine sitting at "unknown device" with no network to pull drivers.
- A notebook with a cracked/black internal screen that you need to drive over HDMI/USB-C.
- A machine that won't boot into Windows at all — handled from the WinPE rescue layer below.
Layer A — Live. Runs inside a working Windows 11 install via Run.bat → engine\OfflineSetup.ps1. One UAC elevation at entry, then menu-driven.
Layer B — WinPE Rescue. A bootable WinPE USB for offline maintenance of a system that no longer starts. The WinPE build chain lives in boot/. Rakuyo does not distribute WinPE media — you build it from your own licensed Windows ADK. See Why there is no ISO.
Rakuyo has no installer. From a working copy of the source:
- Menu / CLI: run
Run.bat. It sets UTF-8, then callsengine\OfflineSetup.ps1with Bypass execution policy for that one process and forwards any arguments. - PowerShell directly: call
engine\OfflineSetup.ps1with parameters such as-DryRun,-Task, and-Preset. - GUI: the WPF front-end is the
Rakuyo.UIproject insrc/. It is not prebuilt — you compile it yourself (see Build). There is no shippedRakuyo.exe.
Always run -DryRun first. It previews every action without changing anything. Rakuyo also creates a system restore point before destructive operations and logs what it does — but a dry run is still your first move.
| Preset | Intent |
|---|---|
presets/protected.json |
Absolute protection whitelist — never removed. |
presets/minimal.json |
Conservative default. Recommended for most machines. |
presets/office.json |
Office-oriented setup. |
presets/keep-gaming.json |
Preserves gaming-related components. |
The GUI and core are a standard .NET solution: src/Rakuyo.sln (projects Rakuyo.Core, Rakuyo.UI, Rakuyo.Core.Tests).
- Install the .NET SDK required by the solution.
- Build:
dotnet build src/Rakuyo.sln -c Release(or open the solution in Visual Studio). - The PowerShell engine (
engine/) needs no build step and runs as-is. - For Layer B (WinPE), you need the Windows Assessment and Deployment Kit (ADK). The build chain and instructions are under
boot/.
Rakuyo is not code-signed (a solo project, no code-signing certificate yet). Because of that:
- SmartScreen ("Windows protected your PC") may appear if you run a self-built binary. Click More info → Run anyway only after you've decided you trust this build.
- Antivirus may flag the scripts or the WinPE tooling. Offline PowerShell that removes Appx packages, calls
pnputil, and builds boot media looks exactly like the behavior AV heuristics distrust — that's expected, not a promise it's clean. - UAC will prompt once, because debloat, driver install, and restore-point creation genuinely require administrator rights.
Why you can still verify it yourself: the entire source is public specifically so you don't have to take an unsigned binary on faith. Read engine/OfflineSetup.ps1, the presets, and the boot/ chain, then build it yourself. Don't run a Rakuyo binary you got from anywhere other than your own build of this repository.
Rakuyo's rescue layer is WinPE-based, and WinPE is Microsoft software. Redistributing a ready-made WinPE ISO carries Microsoft licensing obligations that a solo developer has not cleared. So instead of shipping media, Rakuyo ships a builder: you assemble the WinPE image locally from your own licensed Windows ADK. Nothing from Microsoft is bundled in this repository. This keeps the project on the right side of redistribution rules and means the media you boot was built on your machine, from components you control.
Rakuyo runs with administrator rights, deletes packages, and installs drivers on machines people depend on. Publishing the source is how that power stays auditable: you can read exactly what each task does before you run it. Public source here means "open to inspection," not "free to reuse" — see the license below.
- No network calls, no telemetry, no analytics, no phone-home. It is built to run fully offline.
- No bundled Microsoft binaries (no WinPE image, no system files).
- No bundled drivers — you supply your own signed INF packages.
Test status and verification notes live in docs/BETA_RESULTS.md. This is beta software: expect rough edges, and test on a machine whose data you can afford to lose.
Source-available, all rights reserved. See LICENSE.md.
Rakuyo is published for viewing and evaluation only. Redistribution, distribution of modified versions, and commercial use (including sale or paid-service integration) each require the author's prior written permission. This is a proprietary license — it is not an open-source license. Provided AS IS, without warranty; you assume all risk.
Windows, Windows 11, and Windows PE (WinPE) are trademarks of Microsoft Corporation. Rakuyo is an independent project and is not affiliated with, endorsed by, or sponsored by Microsoft. Any references are for identification only.
- Drivers you add are governed by their own vendors' licenses — you are responsible for the redistribution/usage terms of any INF package you use. See
docs/DRIVER_LICENSING.md. - WinPE / Windows ADK components are Microsoft's and are obtained and licensed by you directly from Microsoft; they are not included here. See
docs/SIGNING.mdanddocs/LEGAL.md.
Made by rakuyou211 (落葉い), solo. Feedback from beta testers is welcome via docs/BETA_FEEDBACK_FORM.md.
Rakuyo（落葉）は、オフライン環境で動くWindows 11向けのレスキュー／セットアップ道具です。デブロート・ドライバ導入・外部モニタ復旧を、稼働中のWindows（Layer A）か、起動しない機体向けのWinPEレスキューUSB（Layer B）から実行します。通信・テレメトリは行わず、Microsoftのバイナリは同梱していません。
現在はクローズドβで、配布可能なISOや署名済みインストーラはまだありません。WinPEはMicrosoftのソフトウェアであり、再配布には同社のライセンス整理が必要なため、Rakuyoは完成品を配らず、利用者が自分の正規Windows ADKからローカルでビルドする方式を採っています。ソースを公開しているのは監査（中身を自分で確認できること）のためで、再利用を許可するものではありません。
本ソフトは未署名のため、SmartScreenやウイルス対策ソフトが警告を出すことがあります。ソースは全て公開されているので、engine/OfflineSetup.ps1 などを読んでから自分でビルドして確認してください。ライセンスは**ソース公開・全権留保（閲覧／評価目的のみ、再配布・商用利用は事前の書面許可が必要）**です。Windows / Windows PE はMicrosoftの商標であり、本プロジェクトは同社と提携していません。