Project Logo

Codex Environment is a comprehensive Data Structures and Algorithms (DSA) learning platform designed to provide an interactive and immersive educational experience. It features algorithm visualizations, an AI-powered practice arena with Socratic hints, and a multi-language code execution engine.

• Algorithm Visualizer: Interactive step-by-step visualizations for Sorting, Searching, Stacks, Queues, Linked Lists, Trees, Graphs, and more.
• AI Practice Arena: Solve coding problems with real-time feedback.
  • Socratic Hints: AI-powered hints that guide you towards the solution without giving it away.
  • Code Review: Instant AI code reviews analyzing correctness, complexity (Time/Space), and style.
• Code Execution Engine: Run code securely in JavaScript, Python, Java, and C++.
• Interactive Tutorials: Learn concepts like Big O notation and Recursion through interactive modules.
• Modern UI: Polished Glassmorphism design system using Tailwind CSS and Framer Motion.

• Framework: React (Vite)
• State Management: Redux Toolkit
• Styling: Tailwind CSS
• Code Editor: Monaco Editor (@monaco-editor/react)
• Animations: Framer Motion
• Icons: Lucide React
• Charts: Recharts

• Server: Node.js & Express
• AI Integration: Google Generative AI
• Security: Helmet, CORS, Rate Limiting
• Execution: Child Processes for multi-language code execution

• Node.js (v18+ recommended)
• npm or yarn
• Google Gemini API Key (for AI features)

git clone <repository-url>
cd Codex Environment

The backend runs the API server and code execution engine.

1. Navigate to the server directory:

   cd backend/server

2. Install dependencies:

   npm install

3. Create a .env file in backend/server/ with the following variables:

   PORT=3000
   GEMINI_API_KEY=your_gemini_api_key_here
   FRONTEND_URL=http://localhost:5173

   (Note: Replace your_gemini_api_key_here with your actual key from Google AI Studio)

4. Start the server:

   npm run dev

   The server will start at http://localhost:3000.

The frontend provides the user interface.

1. Open a new terminal and navigate to the frontend directory:

   cd frontend

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

   The application will be available at http://localhost:5173.

Codex Environment/
├── frontend/ # React + Vite application
│ ├── src/ # Source code (Components, Store, Pages)
│ ├── public/ # Static assets
│ └── package.json # Frontend dependencies
├── backend/ # Backend services
│ ├── server/ # Express API server
│ │ ├── data/ # JSON data files (Algorithms, Questions)
│ │ ├── index.js # Server entry point
│ │ └── package.json # Backend dependencies
│ └── scripts/ # Utility scripts
└── README.md # Project documentation

The code execution engine runs user-submitted code on the server. While basic timeouts and cleanup are implemented, this is intended for a controlled educational environment.

Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.