Discord OS
Discord is the screen. This process is the computer. Your phone is the remote.
SQLite is the database. Up to eight live jobs by default (DISCORD_OS_MAX_LIVE, tunable). Analyze can overlap; implement/swarm writes serialize per checkout. Real ceilings are OpenRouter RPM/TPM/spend, machine CPU/RAM, and Discord limits — not a hard "two cooks" product voice. Puppetmaster runs on this Mac (OpenRouter/agentic only). Artifacts are Discord snowflakes plus sha256. Intake is REST. No hosted fleet.
pip install discord-os
Leave the host running. Turn work on and off from Discord. Job threads are live sessions: reply after Done to cook again in-thread.
Workers need Puppetmaster too:
pip install discord-os puppetmaster-ai
The agent-discord command still works. Full setup, Discord verbs, and docs live in the repo — PyPI does not host those pages.
| Done card | HOST More | Parallel threads |
|---|---|---|
 |
 |
 |
First run
Once, in a browser: Discord Developer Portal → New Application → Bot → Reset Token (DISCORD_BOT_TOKEN) → enable Message Content Intent → General Information → Application ID (DISCORD_APPLICATION_ID). Copy a private channel ID.
Then on the machine that will do the work (Python 3.11+):
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install discord-os puppetmaster-ai
export OPENROUTER_API_KEY=... # never commit
discord-os bootstrap
# put DISCORD_BOT_TOKEN and DISCORD_APPLICATION_ID in .env
discord-os setup --channel-id YOUR_CHANNEL_ID
Open the invite URL, press On. After that, discord-os add and in-channel bind — not a wizard. See docs/setup.
MIT — LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for discord-os 0.5.82
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| discord_os-0.5.82.tar.gz | 481.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| discord_os-0.5.82-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 864.9 kB
Release files / discord_os-0.5.82.tar.gz
| Download URL | discord_os-0.5.82.tar.gz |
|---|---|
| Size | 481.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4ba5c86447e5a97baab0ba519ec214848ee12319d26f6807bee445aa6887e5f3
|
|
BLAKE2b-256 checksum How to use checksums |
f775757a7bac740a1bb3a6ebcf43b419a131e3571f9cdfeb1f32d4d0971c1fa3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / discord_os-0.5.82-py3-none-any.whl
| Download URL | discord_os-0.5.82-py3-none-any.whl |
|---|---|
| Size | 383.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7a52df8850b019a4d181dfb88f36ce3bf465b6e098c2156dcd6f50cde12ab4d4
|
|
BLAKE2b-256 checksum How to use checksums |
f0010d38668a84f74c6377dfeb0d4c5324ceaa5b2570abc6fd7592df1d52b325
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
