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 for playback, library and skins — no account, ever — 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. Generation itself, LoRA training and the community Styles library sit behind a manually issued product key that activates once online and silently renews a short-lived signed lease. Themes and skins are first-class and orthogonal to plugins, driven by a unified design-token vocabulary. In alpha and shipping: the Windows installer, auto-update channel, signed plugin host, generation engine, skin system and track library are all live.
- TypeScript
- Electron
- Svelte
- Vite
- Python
- essentia.js
- aubio
- 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 strict TypeScript on
Electron, with a Svelte +
Vite renderer. Audio analysis runs in-process
via essentia.js and aubio for
tempo and key detection; the shipped generation engine is
ACE-Step 1.5 running as a native C++/GGML
sidecar (acestep.cpp), which the shell talks to
through a neutral engine-provider interface that keeps ACE's own
HTTP dialect confined to an explicit compatibility driver — so a
second engine can plug in without leaking ACE's quirks into the
host. Python is confined to an isolated, opt-in
LoRA training-pack sidecar and never touches the generation
path. 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; a second PHP app behind
WebAuthn passkeys issues and revokes the product keys that gate
generation, training and community Styles. All developer
workflows go through just; CI runs on GitHub
Actions.
Status
Iblis is in public alpha and shipping
continuously. Live today: the Windows installer and auto-update
channel, the signed plugin host and plugin SDK, a v2 engine
registry that can target more than one generation engine at a
time (a Fixture Engine ships in beta to prove the plumbing end
to end), the skin/design-token system, and a track library with
search, folders, sorting, and detected BPM/key badges on every
row. Generation, LoRA training, and the community Styles library
are gated behind a manually issued product key that activates
once online and silently renews a short-lived signed lease —
local library, playback, and skins never need one. Current work
is engine pack 0.1.5 (a native acestep.cpp re-pin
plus an experimental XL Turbo profile) and Create's
capability-driven UI, which reads an engine's signed descriptor
to render only the controls it actually supports.
CHANGELOG.md and ROADMAP.md on the
site render straight from the repo, so the public history is
the real one.
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 the Electron shell with HMR (desktop required)
just site-dev # site only (PHP built-in server)
just site-deploy # production Composer install + checked Apache reload
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
The Windows installer, auto-update channel, signed plugin host, ACE-Step
engine, skin system, generation flow, and library core are live. Run
just pickup for the exact released versions, any active human-test wait,
and the next concrete step; CHANGELOG.md and ROADMAP.md carry the public
history and direction.
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.