Group Chatbot

CLI chatbot over archived Discord messages stored in Neon/Postgres.

It keeps public.discord_messages as the source of truth, derives conversation windows, embeds those windows with Voyage, and uses Claude to answer in a blended group voice grounded in retrieved archive context.

Setup

1. Copy .env.example to .env and fill in:
   • DATABASE_URL
   • ANTHROPIC_API_KEY
   • VOYAGE_API_KEY
2. Install the package:

python3 -m pip install -e '.[dev]'

3. Initialize the derived schema:

chatbot init-db

4. Build windows, embeddings, and style profile:

chatbot build-windows
chatbot embed-windows
chatbot rebuild-style-profile

5. Search or chat:

chatbot search "why were they arguing about discord roles"
chatbot chat

Commands

• chatbot init-db
• chatbot build-windows
• chatbot embed-windows
• chatbot rebuild-style-profile
• chatbot search "<query>"
• chatbot chat

Notes

• init-db creates derived tables only. It does not modify public.discord_messages.
• Vector search uses pgvector. If CREATE EXTENSION vector is unavailable on your Neon project, init-db will fail with a clear error.
• The bot is designed to sound like the group's overall cadence, not impersonate any specific real person.