Delphidelphi

Quick Start

Get Delphi running in under 5 minutes.

1. Clone the repo

git clone https://github.com/JjayFabor/delphi.git
cd delphi

2. Run the setup wizard

python3 scripts/setup.py

The wizard will:

  1. Check your prerequisites (claude, python3, node, git)
  2. Create .env from .env.example
  3. Prompt for your Telegram bot token (get one from @BotFather — send /newbot). Discord is optional — see Connecting Discord
  4. Create runtime directories (data/, logs/, workspaces/)
  5. Install Python dependencies into .venv
  6. Initialize the SQLite database
  7. Optionally install systemd user units on Linux/WSL2

3. Find your Telegram user ID

Start the bot and send it /whoami:

source .venv/bin/activate
python agents/main/agent.py

The bot replies with your numeric user ID. Add it to .env:

TELEGRAM_ALLOWED_USER_IDS=123456789

Then restart the bot.

4. Customize your agent

Edit agents/shared/USER_PROFILE.md with your name, role, timezone, and any context that helps the agent understand you. This is what makes it feel like yours.

5. Start chatting

source .venv/bin/activate
python agents/main/agent.py

Or with systemd: systemctl --user start claude-main.service

The first message in a new session takes a few seconds while the Claude CLI initializes. Subsequent messages are much faster.

What to do next

  • Say "what can you do?" to explore capabilities
  • Say "remember that I prefer concise replies" to teach a preference
  • Say "add the GitHub connector" to connect your first integration