How kavya0224/codex works
CodeX is an AI coding assistant: users submit a problem and optional tests, then receive generated code, execution results, a verdict, retries, and metrics; they can also request a structured explanation. The backend orchestrates planning, generation, sandboxed execution, validation, and debugging, while the React UI presents results and run history. The README documents public/hidden test suites and telemetry; sampled source shows the orchestration and key calls. Some frontend behavior and supporting subsystem internals were not sampled, so those connections rely on README documentation.
Main entry points: solveService.js Solve orchestrator · groqClient.js Groq LLM · codeExecutor.js Sandbox executor · App.jsx React workspace
Components 22
User interface
- React workspace
frontend/src/App.jsx
API entry
- Express server
backend/src/server.js - Solve route
backend/src/routes/solveRoute.js - Explain route
backend/src/routes/explainRoute.js - Solve handler
backend/src/controllers/solveController.js - Explain handler
backend/src/controllers/explainController.js
Solve workflow
- Solve orchestrator
backend/src/services/solveService.js - Explanation service
backend/src/services/explainService.js - Problem planner
backend/src/agents/plannerAgent.js - Code generator
backend/src/agents/codeGeneratorAgent.js - Debug agent
backend/src/agents/debugAgent.js
Execution and checks
- Workspace files
backend/src/execution/fileManager.js - Sandbox executor
backend/src/execution/codeExecutor.js - Test case runner
backend/src/utils/testCaseRunner.js - Output validator
backend/src/utils/outputValidator.js
AI and telemetry
- Groq LLM
backend/src/llm/groqClient.js - Code sanitizer
backend/src/utils/codeSanitizer.js - Run telemetry
backend/src/utils/executionLogger.js - Performance tracker
backend/src/utils/performanceTracker.js
Other components
- Problem solver
- Groq API
- Docker sandbox
backend/sandbox
Connections 27
- Problem solver → React workspace: submits problem
README.md - React workspace → Solve route: POST /solve
README.md - React workspace → Explain route: POST /explain
README.md - Express server → Solve route: mounts route
backend/src/server.js - Express server → Explain route: mounts route
backend/src/server.js - Solve route → Solve handler: routes request
backend/src/routes/solveRoute.js - Explain route → Explain handler: routes request
backend/src/routes/explainRoute.js - Solve handler → Solve orchestrator: calls
backend/src/controllers/solveController.js - Explain handler → Explanation service: calls
backend/src/controllers/explainController.js - Solve orchestrator → Problem planner: creates plan
backend/src/services/solveService.js - Solve orchestrator → Code generator: generates code
backend/src/services/solveService.js - Solve orchestrator → Debug agent: repairs failures
backend/src/services/solveService.js - Code generator → Groq LLM: requests generation
backend/src/agents/codeGeneratorAgent.js - Debug agent → Groq LLM: requests fixes
README.md - Explanation service → Groq LLM: requests explanation
backend/src/services/explainService.js - Groq LLM → Groq API: calls model
backend/src/llm/groqClient.js - Solve orchestrator → Workspace files: saves code
backend/src/services/solveService.js - Sandbox executor → Workspace files: writes input
backend/src/execution/codeExecutor.js - Solve orchestrator → Sandbox executor: executes code
backend/src/services/solveService.js - Sandbox executor → Docker sandbox: runs container
backend/src/execution/codeExecutor.js - Solve orchestrator → Test case runner: runs test suites
backend/src/services/solveService.js - Test case runner → Sandbox executor: executes cases
backend/src/utils/testCaseRunner.js - Test case runner → Output validator: checks outputs
backend/src/utils/testCaseRunner.js - Solve orchestrator → Output validator: validates result
backend/src/services/solveService.js - Groq LLM → Code sanitizer: sanitizes code
backend/src/llm/groqClient.js - Solve orchestrator → Run telemetry: records stages
backend/src/services/solveService.js - Solve orchestrator → Performance tracker: tracks timings
backend/src/services/solveService.js