leemysw/agent-kit
Production-Ready AI Agent Development Framework Powered by Claude Agent SDK
2.8K
leemysw/agent-kit repository overview
Production-Ready AI Agent Development Framework Powered by Claude Agent SDK
基于 Claude Agent SDK 构建的生产级 AI 智能体开发框架
📖 Introduction
Agent Kit is a comprehensive AI agent development framework that integrates Claude Agent SDK, providing a complete solution from frontend to backend. This project aims to help developers quickly build, deploy, and scale production-grade AI Agent applications.
🏗️ Architecture
🚀 Quick Start
Prerequisites
- Python: 3.11 or higher
- Node.js: 24.0 or higher
- Docker & Docker Compose: Latest version
- Agent API Key: Get from Anthropic or Bigmodel
Installation
Option 1: Docker Deployment (Recommended)
1️⃣ Clone the repository
git clone https://github.com/leemysw/agent-kit.git
cd agent-kit
2️⃣ Configure environment variables
# Copy environment variable template
cp example.env .env
# Edit .env file and add your API key
3️⃣ Start services
make start
╰─ make start
TAG=0.1.2 docker compose -f deploy/docker-compose.yml up -d
[+] Running 3/3
✔ Container deploy-agent-kit-1 Started 1.8s
✔ Container deploy-web-1 Started 0.9s
✔ Container deploy-nginx-1 Running 0.0s
✅ Agent Kit is running!
🌐 Web UI: http://localhost
📋 Logs: run 'make logs' to view service logs
4️⃣ Access the application
- Application URL: http://localhost
Option 2: Local Development
1️⃣ Clone the repository
git clone https://github.com/leemysw/agent-kit.git
cd agent-kit
2️⃣ Backend setup
# Install Python dependencies
pip install -r agent/requirements.txt
# Configure environment variables
cp example.env .env
# Edit .env file and add your API key
Configure .env file:
# Claude API configuration
ANTHROPIC_API_KEY=your_api_key_here
ANTHROPIC_BASE_URL=https://api.anthropic.com or https://open.bigmodel.cn/api/anthropic
ANTHROPIC_MODEL=claude-3-5-sonnet-20241022 or glm-4.6
# Server configuration
HOST=0.0.0.0
PORT=8010
DEBUG=true
WORKERS=1
3️⃣ Frontend setup
cd web
# Install dependencies
npm install
# Configure environment variables
cp example.env .env.local
# Edit .env.local file
Configure .env.local file:
# Development environment configuration
NEXT_PUBLIC_API_URL=http://localhost:8010/agent/v1
NEXT_PUBLIC_WS_URL=ws://localhost:8010/agent/v1/chat/ws
NEXT_PUBLIC_DEFAULT_CWD=/opt/app/playground
NEXT_PUBLIC_DEFAULT_MODEL=glm-4.6
4️⃣ Run the project
# Start backend (in project root directory)
python main.py
# Start frontend (in web directory)
npm run dev
5️⃣ Access the application
- Application URL: http://localhost:3000
⚙️ Configuration
Backend Configuration
| Config Item | Description | Default Value |
|---|---|---|
ANTHROPIC_API_KEY | Claude API key | - |
ANTHROPIC_BASE_URL | API base URL | https://api.anthropic.com |
ANTHROPIC_MODEL | Model to use | glm-4.6 |
HOST | Server host | 0.0.0.0 |
PORT | Server port | 8010 |
DEBUG | Debug mode | false |
WORKERS | Number of workers | 1 |
Frontend Configuration
| Config Item | Description | Default Value |
|---|---|---|
NEXT_PUBLIC_API_URL | Backend API URL | http://localhost:8010/agent/v1 |
NEXT_PUBLIC_WS_URL | WebSocket URL | ws://localhost:8010/agent/v1/chat/ws |
NEXT_PUBLIC_DEFAULT_CWD | Working directory | /opt/app/playground |
NEXT_PUBLIC_DEFAULT_MODEL | Default model | glm-4.6 |
📚 Documentation
For detailed guides and API documentation, please visit:
- Frontend API Documentation - React components, types, and API interfaces
- WebSocket Session Flow - WebSocket session and data flow
- Guides - Comprehensive guides for various features
Development Guides
- Session Management - Session creation, management, and message handling
- Streaming vs Single Mode - AI response mode comparison
- Custom Tools - Creating and using custom AI tools
- Slash Commands - Custom slash command development
- Skills Guide - Skill system usage and development
- MCP Integration - Model Context Protocol integration
- Hosting Guide - Production deployment and configuration
- Permissions Management - Permission control and security settings
🤝 Contributing
All forms of contributions are welcome!
Bug Reports & Feature Requests
If you find a bug or have a new feature suggestion, please submit it through GitHub Issues.
Tag summary
Content type
Image
Digest
sha256:ec3a800e5…
Size
246.4 MB
Last updated
6 months ago
docker pull leemysw/agent-kit