@@ -35,8 +35,8 @@ Build, run, and ship full-stack applications with an agent that codes, executes,
3535
3636Cheatcode is a full-stack application that pairs a Next.js dashboard with a FastAPI backend to provide an AI agent capable of:
3737
38- - Creating and modifying projects and threads with a collaborative chat interface
39- - Executing actions inside isolated sandboxes using Daytona for code execution and app previews
38+ - Creating and modifying projects and threads with a collaborative chat interface
39+ - Executing all code operations in isolated sandboxes using Daytona (required for file operations, shell commands, and app previews)
4040- Integrating with multiple LLM providers including OpenAI, Anthropic, OpenRouter, and Groq via LiteLLM
4141- Managing authentication and data through Supabase with Redis for queues and caching
4242- Supporting web browsing and crawling via external APIs with optional billing and usage tracking
@@ -121,11 +121,11 @@ graph TD
121121
122122- ** Supabase project** with URL, anon key, and service role key
123123- ** Clerk application** with publishable key and secret key
124+ - ** Daytona account** with API key, server URL, and target for sandbox code execution and app previews
124125- ** At least one LLM provider** : OpenAI, Anthropic, OpenRouter, or Groq API key
125126
126127### Optional Integrations
127128
128- - ** Daytona account** for sandbox code execution and app previews
129129- ** Sentry** for error monitoring
130130- ** Langfuse** for LLM observability
131131
@@ -155,16 +155,16 @@ CLERK_SECRET_KEY=YOUR_CLERK_SECRET_KEY
155155# Redis (Docker Compose uses service name 'redis')
156156REDIS_URL=redis://redis:6379
157157
158+ # Sandbox Integration (Required)
159+ DAYTONA_API_KEY=YOUR_DAYTONA_API_KEY
160+ DAYTONA_SERVER_URL=YOUR_DAYTONA_SERVER_URL
161+ DAYTONA_TARGET=YOUR_DAYTONA_TARGET
162+
158163# LLM Providers (choose at least one)
159164OPENAI_API_KEY=YOUR_OPENAI_API_KEY
160165ANTHROPIC_API_KEY=YOUR_ANTHROPIC_API_KEY
161166OPENROUTER_API_KEY=YOUR_OPENROUTER_API_KEY
162167
163- # Optional: Sandbox Integration
164- DAYTONA_API_KEY=YOUR_DAYTONA_API_KEY
165- DAYTONA_SERVER_URL=YOUR_DAYTONA_SERVER_URL
166- DAYTONA_TARGET=YOUR_DAYTONA_TARGET
167-
168168# Optional: External Services
169169TAVILY_API_KEY=YOUR_TAVILY_API_KEY
170170FIRECRAWL_API_KEY=YOUR_FIRECRAWL_API_KEY
@@ -214,6 +214,7 @@ docker compose up --build
2142142 . ** Frontend Access** : Visit http://localhost:3000 and sign in with Clerk
2152153 . ** Create Project** : Create a new project and thread
2162164 . ** Test Agent** : Send a message and start the agent
217+ 5 . ** Verify Sandbox** : Ensure Daytona credentials are working - the agent cannot execute code without a properly configured Daytona sandbox environment
217218
218219## Local Development
219220
@@ -272,9 +273,9 @@ npm run dev
272273| ` ANTHROPIC_API_KEY ` | * | Anthropic API key |
273274| ` OPENROUTER_API_KEY ` | * | OpenRouter API key |
274275| ` GROQ_API_KEY ` | * | Groq API key |
275- | ` DAYTONA_API_KEY ` | No | Daytona API key for sandboxes |
276- | ` DAYTONA_SERVER_URL ` | No | Daytona server URL |
277- | ` DAYTONA_TARGET ` | No | Daytona target environment |
276+ | ` DAYTONA_API_KEY ` | Yes | Daytona API key for sandbox code execution |
277+ | ` DAYTONA_SERVER_URL ` | Yes | Daytona server URL |
278+ | ` DAYTONA_TARGET ` | Yes | Daytona target environment |
278279| ` TAVILY_API_KEY ` | No | Tavily API key for web search |
279280| ` FIRECRAWL_API_KEY ` | No | Firecrawl API key for web scraping |
280281| ` LANGFUSE_PUBLIC_KEY ` | No | Langfuse public key for LLM observability |
@@ -527,10 +528,11 @@ sudo usermod -aG docker $USER
527528 - Check rate limits and usage quotas
528529 - Review backend logs for LLM errors
529530
530- 3 . ** Sandbox Issues**
531- - Ensure Daytona credentials are configured
531+ 3 . ** Sandbox Issues** (Required for core functionality)
532+ - Ensure Daytona credentials are configured (required for code execution)
532533 - Check Daytona service status
533534 - Verify network connectivity to Daytona servers
535+ - Note: The agent cannot execute code or create files without working Daytona integration
534536
535537### Getting Help
536538
0 commit comments