English | 简体中文

An AI-powered educational tool built on the iFLYTEK Astron Agent open-source platform, designed to help teachers quickly generate clear course outlines and high-quality teaching content from textbook materials.

This tool leverages the iFLYTEK Astron Agent open-source platform to:

• 📚 Accept textbook content input
• 🎯 Automatically generate structured course outlines
• 📝 Create detailed teaching plans, examples, and exercises for each module
• 💡 Provide teaching suggestions for educators

• Framework: FastAPI (Python 3.10+)
• HTTP Client: httpx (async)
• Data Validation: Pydantic
• AI Platform: iFLYTEK Astron Agent Open Platform

• Framework: React 18 + TypeScript
• Build Tool: Vite
• UI Library: Ant Design 5
• HTTP Client: Axios
• Internationalization: i18next + react-i18next

Before you begin, make sure you have:

• ✅ Python 3.10 or higher installed
• ✅ Node.js 16 or higher installed
• ✅ Successfully deployed iFLYTEK Astron Agent development platform locally
• ✅ Created and published workflows in the iFLYTEK Astron Agent platform

git clone https://github.com/GitHubDaily/AI-Course-Generator.git
cd ai-course-generator

cd backend

# Install dependencies
pip install -r requirements.txt

# Configure environment variables
cp .env.example .env
# Edit the .env file and fill in your iFLYTEK Astron API credentials and workflow IDs

# Start the backend service
uvicorn main:app --reload

The backend will start at http://localhost:8000.

cd frontend

# Install dependencies
npm install

# Configure environment variables (optional, defaults to localhost:8000)
cp .env.example .env.local

# Start development server
npm run dev

The frontend will start at http://localhost:5173.

Open your browser and navigate to http://localhost:5173 to start using the application!

1. Paste or type textbook content in the input box on the home page
2. (Optional) Fill in grade level, subject, and desired number of modules
3. Click the "Generate Course Outline" button
4. Wait for AI processing and view the generated outline

1. On the outline page, click the "View Details" button for any module
2. The system will generate detailed teaching content for that module
3. Review teaching plans, examples, exercises, and teaching suggestions

Click the language switcher button in the top-right corner to toggle between Chinese and English interface.

ai-course-generator/
├── backend/                 # Backend service
│   ├── main.py             # FastAPI main application
│   ├── config.py           # Configuration management
│   ├── models.py           # Data models
│   ├── workflow_client.py  # Workflow client
│   ├── requirements.txt    # Python dependencies
│   ├── .env               # Environment variables
│   └── README.md          # Backend documentation
├── frontend/               # Frontend application
│   ├── src/
│   │   ├── components/    # React components
│   │   ├── services/      # API services
│   │   ├── types/         # Type definitions
│   │   ├── i18n/          # Internationalization config
│   │   ├── App.tsx        # Main application
│   │   └── main.tsx       # Entry file
│   ├── package.json       # Frontend dependencies
│   └── README.md          # Frontend documentation
├── docs/                   # Project documentation
└── README.md              # This file

After starting the backend, access the API documentation at:

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

# Application information from local Astron Agent platform
Astron_API_KEY=your_api_key
Astron_API_SECRET=your_api_secret

# Workflow IDs
WORKFLOW_1_ID=your_workflow_1_id  # Course outline generation
WORKFLOW_2_ID=your_workflow_2_id  # Module details generation

# Server configuration
BACKEND_PORT=8000
CORS_ORIGINS=http://localhost:3000,http://localhost:5173

VITE_API_BASE_URL=http://localhost:8000

• Backend framework
• Workflow client wrapper
• Data model definition
• API endpoint implementation
• Frontend project setup
• UI component development
• API integration
• Internationalization (Chinese/English)
• Testing and optimization
• Deployment documentation

1. API Credentials: Valid iFLYTEK Astron API credentials are required
2. Workflows: Workflows must be created and configured in the local iFLYTEK Astron Agent platform beforehand
3. Timeout Settings: API call timeout is set to 120 seconds
4. Text Length: Recommended maximum textbook content length per request is 10,000 characters

• Check if Python version is >= 3.10
• Verify environment variables in .env file are correctly configured
• Review terminal error messages

• Confirm backend service is running
• Check if API address in .env.local is correct
• Review browser console network requests

• Verify iFLYTEK Astron API credentials are valid
• Confirm workflow IDs are correct
• Check backend logs for detailed errors

Issues and Pull Requests are welcome!

MIT License

For questions, please submit an Issue or contact the development team.

Development Documentation: Check the docs/ directory for more details

Quick Start Checklist: docs/Quick Start Checklist - Claude.md

Product Requirements Document: docs/RPD.md