🚧 项目状态: 目前处于全力开发阶段，版本更新比较频繁，敬请关注。

AIForge 是一个智能执行引擎，它消除了自然语言指令与代码执行之间的壁垒。通过先进的指令分析和自适应执行架构，AIForge 提供：

• 🧠 深度理解：多维度指令解析，精准捕获意图
• ⚡ 即时执行：快速代码生成，实时环境交互
• 🌊 多模式部署：CLI、Web API、桌面 GUI
• 🎭 多 LLM 支持：OpenAI、DeepSeek、OpenRouter、Ollama
• 🔮 智能缓存 - 基于语义相似性的智能代码复用
• 🌊 自我进化 - 持续学习优化，错误自愈能力

核心哲学: Thought → Code → Reality - 让思维直接驱动现实世界

• CLI接口 - 直接执行的命令行工具
• Python API - 应用程序的编程集成
• Web API - 基于FastAPI的REST接口
• 桌面GUI - 桌面级GUI客户端支持

• 语义缓存 - 基于指令相似性的智能代码复用
• 模板系统 - 领域特定的执行模板
• 搜索集成 - 多引擎搜索能力（百度、Bing、360、搜狗），支持SearXNG集成
• 内容生成 - 专业的内容创建工作流

• 全球化指令处理 - 支持12种主要语言的自然语言指令识别
• 本地化关键词 - 中文、英文、阿拉伯语、德语、西班牙语、法语、印地语、日语、韩语、葡萄牙语、俄语、越南语
• 智能语言检测 - 自动识别用户指令语言并匹配相应的关键词库
• 跨语言兼容 - 保持英文关键词通用性的同时提供本地化体验

• Docker部署 - 同时支持两种部署方式
• 进度跟踪 - 实时执行状态指示器
• 错误处理 - 全面的异常管理和重试逻辑
• 配置管理 - 灵活的TOML配置系统

AIForge提供多层安全保障，确保AI代码安全执行：

• 沙盒隔离：进程级隔离执行，完整资源限制
• 网络安全：四级策略控制，智能域名过滤
• 代码分析：危险模式检测，安全模块导入
• 统一中间件：可扩展的安全验证框架

• 生产模式（安装包）

pip install aiforge-engine    
  
# 包含可选依赖    
pip install "aiforge-engine[all]"  # 所有功能（依赖）    
pip install "aiforge-engine[gui]"  # 终端GUI支持    
pip install "aiforge-engine[web]"  # Web API支持    
pip install "aiforge-engine[deploy]" # 部署支持
pip install "aiforge-engine[web,deploy]" # 安装WEB和部署支持

• 开发模式（源码模式）

# 下载源码
git clone https://github.com/iniwap/AIForge.git  
cd AIForge

# 创建并激活虚拟环境
uv venv --python 3.10  
source .venv/bin/activate  # macOS/Linux  
# 或 .venv\Scripts\activate  # Windows

# 安装所有开发依赖
uv sync --all-extras

• 生产模式（安装包）

# 直接模式
from aiforge import AIForgeEngine    
print(AIForgeEngine(api_key="your-openrouter-apikey").("获取全球最新股市趋势并生成投资建议"))

# CLI 模式
aiforge "获取全球最新股市趋势并生成投资建议" --api-key sk-or-v1-xxx
  
# Web 服务
aiforge web # --api-key sk-or-v1-xxx  # 访问 http://localhost:8000  

# Web Docker
export OPENROUTER_API_KEY="your-key-here"
aiforge-deploy docker start --searxng

# 桌面应用
aiforge gui # --api-key sk-or-v1-xxx

• 开发模式（源码模式）

# 直接模式
from aiforge import AIForgeEngine    
print(AIForgeEngine(api_key="your-openrouter-apikey").("获取全球最新股市趋势并生成投资建议"))

# CLI 模式
./aiforge-dev.sh "获取全球最新股市趋势并生成投资建议" --api-key sk-or-v1-xxx # win : ./aiforge-dev.bat
  
# Web 服务
./aiforge-dev.sh web  # 访问 http://localhost:8000，填写API KEY

# Web Docker
export OPENROUTER_API_KEY="your-key-here" # 也可以不带，打开web页面后配置
./aiforge-dev.sh docker start --searxng --dev

# 桌面应用
./aiforge-dev.sh gui # 填写API KEY，也可以带参数启动 --api-key sk-or-v1-xxx

# 桌面应用一体化启动，GUI本地连接后端WEB服务器模式
./aiforge-dev.bat gui --auto-remote

• AIForge 命令使用对比表

• 通用参数说明

• 环境变量支持

• 高级参数传递

# 提供商特定配置  
forge = AIForgeEngine(  
    api_key="your-deepseek-key",  
    provider="deepseek",
    locale="en", # ar|de|en|es|fr|hi|ja|ko|pt|ru|vi|zh
    max_rounds=5,
)  

# 复杂任务执行  
result = forge.run(  
    "构建实时数据监控系统",  
    system_prompt="你是一位高级软件架构师"  
)  

# aiforge.toml  
max_tokens = 4096  
max_rounds = 5  
default_llm_provider = "openrouter"  

[llm.openrouter]  
type = "openai"  
model = "deepseek/deepseek-chat-v3-0324:free"  
api_key = "your-key"  
base_url = "https://openrouter.ai/api/v1"  
timeout = 30  
max_tokens = 8192  

# 从配置文件加载  
forge = AIForgeEngine(config_file="aiforge.toml")  

• 市场分析 - 实时数据挖掘与趋势预测
• 风险评估 - 多维度风险模型构建
• 决策支持 - 数据驱动的智能决策引擎

• 数据科学 - 自动化实验设计与分析
• 模型训练 - 智能超参数优化
• 研究辅助 - 数据可视化与展示

• 原型验证 - 快速MVP构建
• API集成 - 智能接口适配
• DevOps自动化 - 系统监控与维护

• 内容生成 - 多媒体内容智能创作
• 数据艺术 - 将数据转化为视觉艺术
• 交互设计 - 智能UI/UX原型生成

AIForge 不仅是工具，更是通往认知计算时代的桥梁：

• 🧠 神经符号融合 - 结合符号推理与神经网络
• 🌊 流式思维 - 实时思维流的捕获与执行
• 🎯 意图预测 - 基于上下文的需求预判
• 🔄 自我进化 - 持续学习的智能体系统

# 开发者设置  
git clone https://github.com/iniwap/AIForge.git  
cd AIForge  
pip install -e ".[dev]"  

# 运行测试  
pytest tests/  

• 🌐 官网: aiforge.dev
• 💬 社区: Discord
• 📧 联系: [email protected]
• 🐦 动态: @AIForge
• 📦 PyPI: aiforge-engine