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.79
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.79.tar.gz | 474.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| discord_os-0.5.79-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 853.3 kB
Release files / discord_os-0.5.79.tar.gz
| Download URL | discord_os-0.5.79.tar.gz |
|---|---|
| Size | 474.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5eab9b705f673c14abd3692c55e22e4ab73d650e0fa1b18a3f0b4dfc72a123f6
|
|
BLAKE2b-256 checksum How to use checksums |
2740d5dba2ccf7c76392c79f8632a3239d6d83ef12e3aad1e8309fb0ce6410c6
|
| 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.79-py3-none-any.whl
| Download URL | discord_os-0.5.79-py3-none-any.whl |
|---|---|
| Size | 379.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
74c9b7e7f7071764448ccf4c75872b0d17809687e8dd57938b83b6490a8c387e
|
|
BLAKE2b-256 checksum How to use checksums |
964cdf736e849b5601b15acf4b15e2dc86dde7571011048df14a91609b13f0c0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
