Gradient Bang is an online multiplayer universe where gameplay and systems are driven by AI agents. The stack includes:
- Supabase (edge functions + database) for the game server
- Python services (bot + agents)
- Web client in
client/
Most important code in this repo:
src/gradientbang/voice/VoiceTaskManager- core of the voice botsrc/gradientbang/tasks/TaskAgent- long-running task harnessdeployment/supabase/functions/- all game server logicclient/- web client for the game
- Start Supabase locally:
npx supabase start --workdir deployment/
- Run edge functions locally:
npx supabase functions serve --workdir deployment --no-verify-jwt --env-file .env.supabase
- Start the bot:
set -a && source .env.supabase && set +a && uv run bot --host 0.0.0.0
- Legacy game_server code has been removed. Supabase edge functions are the only backend.
- Always use
uv run ...for Python commands and scripts. - You can look directly at Supabase tables and Supabase logs for Supabase running locally. Config is
.env.supabase. - Supabase command is
npx run supabase --workdir deployment. - To run Supabase edge functions:
npx supabase functions serve --workdir deployment --no-verify-jwt --env-file .env.supabase. - To start the bot:
set -a && source .env.supabase && set +a && uv run bot --host 0.0.0.0. - If you need to run edge functions or start the bot, redirect ALL output to a file. Do NOT use
tee; usehead,tail,grep, etc. to inspect log files.