Discord OS

Discord is the screen. This process is the computer. Your phone is the remote.

pip install discord-os

Your bot, on your machine. No hosted fleet. Leave the host running; turn work on and off from Discord.

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.

HOST card and a finished job thread

Two asks at once, live thinking card

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.

Development Status
- 3 - Alpha
Environment
- Console
Intended Audience
- Developers
License
- OSI Approved :: MIT License
Programming Language
Topic
- Communications :: Chat

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

discord_os-0.5.7.tar.gz (193.5 kB view details)

Uploaded Aug 21, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

discord_os-0.5.7-py3-none-any.whl (171.6 kB view details)

Uploaded Aug 21, 2026 Python 3

File details

Details for the file discord_os-0.5.7.tar.gz.

File metadata

Download URL: discord_os-0.5.7.tar.gz
Upload date: Aug 21, 2026
Size: 193.5 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.14.7

File hashes

Hashes for discord_os-0.5.7.tar.gz
Algorithm	Hash digest
SHA256	`a8f01ad319164a9cbec033242b3f24eea2b923ddfcbd8cda48f6c5db38fcfb9b`
MD5	`769cf894c4bb08d69766370bfa3cad08`
BLAKE2b-256	`12b9bb5e20b28d5085243db100614ab102497395fcb81368ac7b8f59c48ae002`

See more details on using hashes here.

File details

Details for the file discord_os-0.5.7-py3-none-any.whl.

File metadata

Download URL: discord_os-0.5.7-py3-none-any.whl
Upload date: Aug 21, 2026
Size: 171.6 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.14.7

File hashes

Hashes for discord_os-0.5.7-py3-none-any.whl
Algorithm	Hash digest
SHA256	`2c490ba356b6922e857e5ad7af1f7fe69d85a270f2a3363129be56587f9d3472`
MD5	`195da0a82f620b1ebb44ce3ca102b49e`
BLAKE2b-256	`a04cf015339b5011e05c0ba43fb0d31a6073e2b20d0d9df9eaf49f204e502d32`