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.77
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.77.tar.gz | 460.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| discord_os-0.5.77-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 827.4 kB
Release files / discord_os-0.5.77.tar.gz
| Download URL | discord_os-0.5.77.tar.gz |
|---|---|
| Size | 460.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6848278bf9c9822d13e9a07c1c2d5a7b26ccbee2ed8011cc21b91ba6b0277d74
|
|
BLAKE2b-256 checksum How to use checksums |
3f4cdf6d82660aef799675721082d4f23d0d87aa76090cf5faa74f54d50476ca
|
| 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.77-py3-none-any.whl
| Download URL | discord_os-0.5.77-py3-none-any.whl |
|---|---|
| Size | 366.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b1951e0a281bd0a7183a41f70acaa47c28bb23aa5dd64fb032d3e56de1b27553
|
|
BLAKE2b-256 checksum How to use checksums |
967a22660c9429e6b84221b3f248da6e7a7c0968b02493e02760bbadb2d233b5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
