Discord OS

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

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

Public package is discord-os. Repo: professorpalmer/discord-os. The agent-discord command still works.

Setup

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. That is the whole first run.

Workflow seams after that — not a wizard:

discord-os add realm puppetmaster --channel-id ID
discord-os add memory --channel-id ID
discord-os add wiki --url https://portablellm.wiki/you --token …
discord-os add github --token ghp_...
discord-os add tool aws --bin aws
discord-os add list

From Discord you can also type bind puppetmaster or bind memory in that channel. See docs/setup.

From Discord

Docs

Read these if you are an agent in this repo. Start at docs/.

pip install -e ".[dev]"
pytest

MIT — LICENSE. Third-party Discord adapters: THIRD_PARTY_NOTICES.md.