Iblis
Local-first AI music workstation for Windows — an Electron shell with a hot-swappable plugin architecture.
Iblis is a local-first AI music workstation for Windows 11. It runs offline by default — no cloud, no account — as an Electron shell where everything beyond text-to-song (image generation, stem splitting, BPM/key detection, waveform visualization, a node editor, a file-explorer view) is a hot-swappable plugin. Themes and skins are first-class and orthogonal to plugins, driven by a unified design-token vocabulary. Early stage: the public site and signed-release pipeline are up; the workstation itself is pre-MVP.
- TypeScript
- Electron
- PHP
- just
- GitHub Actions
- Windows 11
Iblis is a local-first AI music workstation for Windows 11. It is built to run entirely on the user's machine — offline by default, no cloud dependency, no account or sign-in. The application is an Electron shell with a deliberately small core; almost every capability is a plugin.
Plugin-first architecture
- The shell ships only text-to-song. Image generation, stem splitting, BPM/key detection, waveform visualization, the node editor, and the file-explorer view are all hot-swappable plugins against a strict plugin contract.
- Plugins and skins are orthogonal — skins never reach into plugin logic and vice versa.
- Skins are first-class. Four ship by
default —
dark-3d(the default, red/blue lens styling),light-paper,infernal, andcathedral— all expressed through a single shared design-token vocabulary so themes are live-swappable without touching component code.
How it's wired
The workstation is TypeScript (strict) on
Electron. The public site and release channel
at iblis.meiuxmeiux.com
is a small PHP application (phpstan level 7+)
that serves a signed release catalog — a versioned JSON
manifest plus detached signatures — so the installer can verify
and pull the latest signed build. All developer workflows go
through just; CI runs on GitHub Actions.
Status
Iblis is in early development (pre-MVP). The marketing site, signed-release pipeline, and skin/token system are taking shape; the workstation core is still being built. Listed here as a forward-looking entry rather than a finished product.
Straight from the source
The project's own README.
Rendered in place — every link, image, and code block carried over from the repo. The page below is what a contributor would see opening the project for the first time.
Iblis
Local-first AI music workstation for Windows 11. An Electron shell with a strict plugin architecture — every capability beyond text-to-song (image gen, stem split, BPM/key detect, waveform vis, node editor, file-explorer view) is a hot-swappable plugin. Themes/skins are first-class and orthogonal to plugins.
Brand parent: Meiux Meiux LLC. Owner: Jack (saintpetejackboy).
Site: https://iblis.meiuxmeiux.com (vhost on this server).
Repo target: github.com/saintpetejackboy/iblis (private).
Getting started
just doctor # check prerequisites
just dev # run shell + site in dev mode
just site-dev # site only (PHP built-in server)
just site-deploy # rsync apps/site/public/ → /var/www/iblis/public_html/
See docs/quick-start.md for the full walkthrough.
Where to look
| You want to… | Read |
|---|---|
| Understand the project scope and rules | docs/00-charter.md |
| Pick up the repo cold (human or AI) | docs/quick-start.md |
| Understand the architecture in one page | docs/architecture.md |
| Author or modify a plugin | docs/feature/plugins.md |
| Author or modify a skin | docs/feature/skins.md |
| Add a waveform visualization | docs/feature/waveforms.md |
| Touch the audio engine plugin | docs/feature/engines.md |
| Add a processor (stems, BPM, key) | docs/feature/processors.md |
| Edit the website | docs/feature/website.md |
| Calibrate the Lucifer running-gag tone | docs/feature/copy-and-tone.md |
| See what's planned vs shipped | ROADMAP.md / CHANGELOG.md |
The website renders CHANGELOG.md and ROADMAP.md directly from this repo.
There is no second copy.
House rules
Enforced by review and (where possible) by CI. Full list in docs/00-charter.md §House-Rules. Highlights:
- Files soft-cap ~400 LOC, functions ~80 LOC, CSS ~250 LOC. Split when a file is doing two things, not when a counter ticks.
- Strict TypeScript; PHP at phpstan level 7+.
- No secrets in source;
.envonly. - Additive-only DB migrations.
- All dev workflows go through
just. - No emojis in product copy. Ever.
Status
v0.0.0 — repo scaffold. Nothing runs yet. See CHANGELOG.md and ROADMAP.md
for the next move.
Build something like this
Want a tool like this for your shop?
We've shipped this kind of thing before. Twenty-minute intro call, no slides.