English · 简体中文 · User Guide · Architecture Spec
Connect to 18 vendors (11 direct + 7 Coding Plan aggregators), 300+ models.
Built-in Word/Excel/PPT office automation capabilities.
Single static Go binary, zero runtime dependencies, seamless cross-platform coverage.
fairpeer is a universal AI coding assistant that supports 11 direct vendors and 7 Coding Plan aggregator platforms, providing complete office automation capabilities.
- 🌐 Multi-Vendor Support — 18 vendors, unified configuration management
- 💻 Code Editing — 5 editing strategies + 5-level fuzzy matching + checkpoint rollback
- 📄 Office Automation — Full Word/Excel/PPT support
- 🧠 Smart Memory — Two-layer long-term memory + Dream agent + RAG knowledge base
- 🎯 Task Orchestration — Auto-plan + Goal mode + Expert teams
- 🔧 Plugin System — Markdown Skill + MCP plugins
- 📷 Screenshot Solver — One-hotkey exam assistant, AI reads screen and answers
# macOS / Linux
curl -fsSL https://fairpeer.dev/install.sh | bash
# Windows (PowerShell)
irm https://fairpeer.dev/install.ps1 | iex
# Or download from GitHub Releases
# https://github.com/zzycxz/fairpeer/releases# Initialize configuration
fairpeer setup
# Or manually edit config file
vim ~/.config/fairpeer/fairpeer.toml# Start interactive chat
fairpeer
# Execute a single task
fairpeer run "Help me write a Hello World"
# Start desktop app
fairpeer-desktop| Vendor | Base URL | Default Model |
|---|---|---|
| Qwen | https://dashscope.aliyuncs.com/compatible-mode/v1 |
qwen3.7-max |
| DeepSeek | https://api.deepseek.com |
deepseek-v4-pro |
| Volcengine | https://ark.cn-beijing.volces.com/api/v3 |
doubao-seed-evolving |
| Zhipu AI | https://open.bigmodel.cn/api/paas/v4 |
glm-5.2 |
| MiniMax | https://api.minimaxi.com/v1 |
minimax-m3 |
| Moonshot | https://api.moonshot.cn/v1 |
kimi-k3 |
| MiMo | https://api.xiaomimimo.com/v1 |
mimo-v2.5-pro |
| StepFun | https://api.stepfun.com/v1 |
step-3.7-flash |
| iFlytek MaaS | https://spark-api-open.xf-yun.com/v1 |
glm-5.2 |
| Anthropic | https://api.anthropic.com |
claude-sonnet-5 |
| OpenAI | https://api.openai.com/v1 |
gpt-5.6-terra |
| Platform | Base URL | Description |
|---|---|---|
| Qwen Coding | https://coding.dashscope.aliyuncs.com/v1 |
Aggregates qwen/kimi/glm/minimax |
| Zhipu GLM Coding | https://open.bigmodel.cn/api/coding/paas/v4 |
GLM series |
| Volcengine Coding | https://ark.cn-beijing.volces.com/api/coding/v3 |
Aggregates doubao/deepseek/kimi |
| Baidu Qianfan | https://qianfan.baidubce.com/v2/coding |
Aggregates ernie/glm/kimi/deepseek |
| Tencent TokenHub | https://api.lkeap.cloud.tencent.com/coding/v1 |
Aggregates deepseek/glm/kimi/minimax |
| StepFun Step Plan | https://api.stepfun.com/step_plan/v1 |
step series |
| iFlytek MaaS Coding | https://maas-token-api.cn-huabei-1.xf-yun.com/v2 |
Unified model ID |
# Create Word document
fairpeer run "Create a project report.docx with title, paragraphs and tables"
# Insert images
fairpeer run "Insert logo.png into report.docx"
# Generate table of contents
fairpeer run "Generate table of contents for report.docx"# Create Excel spreadsheet
fairpeer run "Create sales_data.xlsx with months and sales"
# Add charts
fairpeer run "Add bar chart to sales_data.xlsx"
# Add conditional formatting
fairpeer run "Add conditional formatting to sales column in sales_data.xlsx"# Create PPT
fairpeer run "Create a presentation about AI"
# Use template
fairpeer run "Create PPT using template, topic is digital transformation"
# Add animation
fairpeer run "Add fade-in animation to PPT"FairPeer supports two-layer long-term memory:
- Document Layer —
fairpeer.mdfile, automatically loaded into context - Auto Memory — Dream agent automatically consolidates knowledge
# Import documents
fairpeer run "Import this PDF into knowledge base"
# Search knowledge base
fairpeer run "Search for authentication system knowledge"
# Answer questions using knowledge base
fairpeer run "Answer this technical question using knowledge base"# Complex tasks automatically trigger planning
fairpeer run "Refactor authentication module, add JWT support, write unit tests"
# → Auto plan → User approval → Execute# Autonomous execution until completion
fairpeer goal "Fix all TypeScript errors"
# → Autonomous work → Detect blockers → Complete/Report# Multi-expert collaboration
fairpeer team review "Review this PR"
# → Security expert + Performance expert + Architecture expert → Comprehensive report# List available skills
fairpeer skill list
# Install skill
fairpeer skill install code-review
# Create custom skill
fairpeer skill new my-skill# fairpeer.toml
[[plugins]]
name = "my-mcp-server"
type = "stdio"
command = "node"
args = ["server.js"]~/.config/fairpeer/fairpeer.toml # Global config
./fairpeer.toml # Project config
./.env # Environment variables
# Default model
default_model = "deepseek/deepseek-v4-pro"
# Provider configuration
[[providers]]
name = "deepseek"
kind = "openai"
base_url = "https://api.deepseek.com"
api_key_env = "DEEPSEEK_API_KEY"
default = "deepseek-v4-pro"
fast_model = "deepseek-v4-flash"
context_window = 1000000
# Context management
[agent]
soft_compact_ratio = 0.5
compact_ratio = 0.8
compact_force_ratio = 0.9
# Office automation
[cowork]
vlm_model = "openai/gpt-4o"
screenshot_vlm_model = "openai/gpt-4o"# Clone repository
git clone https://github.com/zzycxz/fairpeer.git
cd fairpeer
# Install dependencies
go mod download
# Build CLI
go build -o fairpeer ./cmd/fairpeer
# Build desktop app
cd desktop
wails build# Run all tests
go test ./...
# Run specific tests
go test ./internal/config/...| Reference | Content |
|---|---|
| User Guide | Permissions, sandbox, MCP plugins, slash commands, @ syntax, Plan mode |
| Architecture Spec | Engineering contract: system architecture, registry mechanism, data types |
| Features | Complete feature panorama, architecture diagram, capability matrix |
| Office Automation | Word/Excel/PPT automation, email integration, calendar tasks |
| RAG Knowledge Base | Document import, knowledge graph, entity extraction, semantic search |
| Expert Teams | Multi-model collaboration, team configuration, collaboration modes |
| Contributing | Developer guide: how to add new tools, providers, and bot channels |
| Changelog | Historical release records and feature iterations |
If you find FairPeer useful, please consider sponsoring us. Your support will be used for:
- 🤖 Token purchases for development and testing
- 🚀 Feature development and maintenance
- 📚 Documentation improvements
Contributions are welcome! Please see CONTRIBUTING.md.
MIT License - see LICENSE
FairPeer — The most powerful universal multi-vendor AI coding assistant!