EasyC 🚀

English | 简体中文

An intuitive, AI-powered platform designed to make learning C programming accessible and engaging for complete beginners.

🌟 Features

1. Exercise System

• Chapter-based exercise organization
• Real-time code validation
• Answer viewing support
• Progress tracking (Coming Soon)

2. Code Compilation & Execution

• Real-time C code compilation
• Interactive code execution
• Comprehensive error handling
• Program input/output support

3. AI-Powered Analysis

• Intelligent code review
• Optimization suggestions
• Error diagnosis
• Learning recommendations

4. User Interface

• Clean and intuitive design
• Real-time feedback
• Responsive layout
• Syntax highlighting

🔧 System Architecture

EasyC
├── Frontend (Gradio)
│   ├── Welcome Tab
│   ├── Exercise Tab
│   ├── Compiler Tab
│   └── Settings Tab
│
├── Backend Services
│   ├── Exercise Service
│   ├── Compiler Service
│   └── AI Feedback Service
│
└── Utils
    ├── Logger
    └── Path Management

🚀 Quick Start

Using Docker (Recommended)

# Clone the repository
git clone https://github.com/ophiraShen/EasyC.git

# Start with Docker Compose
docker-compose up --build

Manual Installation

# Clone the repository
git clone https://github.com/ophiraShen/EasyC.git

# Install dependencies
pip install -r requirements.txt

# Start the application
python src/main.py

💻 Requirements

System Requirements

• Python 3.10+
• GCC Compiler
• Docker (optional)
• DeepSeek API Key (for AI features)

Dependencies

• Gradio 5.4.0
• Python-dotenv 1.0.1
• Loguru 0.7.2
• Additional dependencies in requirements.txt

🛠️ Development

Project Structure

src/
├── backend/               # Backend services
│   ├── ai/               # AI analysis
│   ├── compiler/         # Code compilation
│   └── exercise/         # Exercise system
├── frontend/             # UI components
│   ├── static/          # Static resources
│   └── tabs/            # UI tabs
├── utils/               # Utilities
└── main.py              # Entry point

Key Components

1. Frontend Module

   • Welcome page
   • Exercise system
   • Code compiler
   • Settings management

2. Backend Module

   • Exercise management
   • Code compilation
   • AI analysis
   • Error handling

3. Utils Module

   • Logging system
   • Path management
   • Common utilities

📝 Documentation

Detailed documentation for each module:

• Frontend Documentation
• Backend Documentation
• Utils Documentation

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

🔒 Security

• Secure code execution environment
• API key protection
• Regular security updates
• Resource usage limits

📈 Future Plans

1. Feature Expansion

   • Exercise progress tracking
   • Multiple test case support
   • Learning resource integration
   • Code auto-save functionality

2. Technical Improvements

   • Parallel test execution
   • Enhanced AI capabilities
   • Performance optimization
   • Mobile responsiveness

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• DeepSeek team for AI capabilities
• GCC team for the C compiler
• Docker for containerization
• All our contributors and supporters

📬 Contact

Project Link: https://github.com/ophiraShen/EasyC

---

Made with ❤️ for aspiring C programmers