MIT开源的企业级场景驱动AI Agent操作系统
MIT Open Source Enterprise Scene-Driven AI Agent OS
让AI能力像乐高一样自由组合
Combine AI capabilities like LEGO blocks
简介 • 安装 • 快速开始 • 功能特性 • 文档 • 贡献
--- ## 简介 / Introduction ### 中文 Apex OS 是一个 **MIT 开源** 的企业级场景驱动 AI Agent 操作系统。基于 **ooderAgent** 智能体框架和 **SceneEngine SDK** 场景引擎构建，提供完整的 AI 应用部署和管理基础设施。支持云端大模型（OpenAI、DeepSeek、千问等）和本地大模型（Ollama、vLLM），具备四级用量统计、场景组持久化、技能热插拔等企业级特性。 ### English Apex OS is a **MIT open source** enterprise scene-driven AI Agent operating system. Built on **ooderAgent** framework and **SceneEngine SDK**, it provides complete infrastructure for AI application deployment and management. Supports cloud LLMs (OpenAI, DeepSeek, Qwen, etc.) and local LLMs (Ollama, vLLM), with enterprise features like 4-level usage tracking, scene group persistence, and hot-swappable skills. ### 系统架构 / System Architecture  ### 场景激活流程 / Scene Activation Flow       --- ## 核心理念 / Core Philosophy | 理念 / Philosophy | 说明 / Description | |-------------------|-------------------| | 🎯 **场景驱动 / Scene-Driven** | 以业务场景为中心，而非技术 API / Business scene-centric, not API-centric | | 🚀 **开箱即用 / Out of Box** | 零配置，5秒启动 / Zero configuration, 5-second startup | | 🔌 **灵活扩展 / Flexible Extension** | 技能热插拔，按需扩展 / Hot-swappable skills, on-demand scaling | | 📊 **成本可控 / Cost Control** | 四级用量统计，精准掌控开支 / 4-level usage tracking, precise cost control | --- ## 为什么选择 Apex？ / Why Apex? ``` 传统方案 (Traditional) Apex ───────────────────────────────────────────── 部署时间: 数天至数周 → 5秒启动 (5s startup) 技术门槛: 需要专业团队 → 零配置 (Zero config) 最低配置: 4GB+ 内存 → 128MB 成本控制: 难以追踪 → 四级统计 (4-level tracking) 知识记忆: 无/临时 → 永久记忆 (Permanent memory) 扩展能力: 代码开发 → 技能热插拔 (Hot-swap skills) 开源协议: 商业/闭源 → MIT ``` --- ## Installation / 安装 ### Prerequisites / 前置要求 | Requirement | Version | Notes | |-------------|---------|-------| | Java | 21+ | GraalVM 21 recommended / 推荐 GraalVM 21 | | Maven | 3.8+ | For building (optional) / 用于构建（可选） | ### Installation Versions / 安装版本 | Version | Memory | Startup | Features | Use Case | |---------|--------|---------|----------|----------| | **Micro** | 128MB | 5s | Core features | Lightweight scenarios / 轻量级场景 | | **Small** | 256MB | 10s | Core + LLM | Small teams, local LLM / 小团队 | | **Large** | 512MB | 15s | Full features | SMEs, knowledge base / 中小企业 | ### Quick Install / 快速安装 ```bash # Clone repository / 克隆仓库 git clone https://gitee.com/ooderCN/apex.git cd apex # Build (optional, skip if using release package) / 构建（可选） mvn clean package -DskipTests # Run (default micro mode) / 运行（默认micro模式） java -jar target/apex-core-1.0.0.jar ``` --- ## Quick Start / 快速开始 ### 1. Start Service / 启动服务 ```bash # Micro mode - lightweight deployment / 轻量级部署 java -Xms128m -Xmx256m -jar apex-core-1.0.0.jar # Small mode - local LLM support / 本地LLM支持 java -Xms256m -Xmx512m -jar apex-core-1.0.0.jar --spring.profiles.active=small # Large mode - full features / 完整功能 java -Xms512m -Xmx1g -jar apex-core-1.0.0.jar --spring.profiles.active=large ``` ### 2. Access Console / 访问控制台 Open browser: `http://localhost:8084` ### 3. Configure LLM / 配置LLM | Provider | Config | Notes | |----------|--------|-------| | OpenAI | API Key, Model | GPT-3.5/GPT-4 | | DeepSeek | API Key, Model | DeepSeek Chat | | Qwen | API Key, Model | Qwen-Plus/Qwen-Max | | Ollama | Base URL, Model | Local models / 本地模型 | ### 4. Install Skills / 安装技能 Browse and install skills from the Skill Marketplace, or upload custom skill packages. --- ## Features / 功能特性 ### 🎯 Scene-Driven Model / 场景驱动模型 ``` Scene = Participants + Capabilities + Knowledge Base + LLM 场景 = 参与者 + 能力 + 知识库 + LLM ``` - **Participants / 参与者**: Users, Agents, Devices / 用户、Agent、设备 - **Capabilities / 能力**: Executable function units / 可执行的功能单元 - **Knowledge Base / 知识库**: Scene-related knowledge / 场景相关的知识资料 - **LLM**: Large Language Model configuration / 大语言模型配置 ### 🧠 Permanent Memory LLM / 永久记忆大模型 | Feature | Description | |---------|-------------| | LLM + Knowledge Base | Enterprise-specific knowledge storage / 企业专属知识存储 | | Vector Embedding | Multiple embedding models supported / 支持多种嵌入模型 | | RAG Enhancement | Precise knowledge retrieval / 精准知识检索 | | Document Management | Multi-format document support / 多格式文档支持 | ### 📊 4-Level Usage Tracking / 四级用量统计 ``` Company → Department → User → Module 公司 → 部门 → 用户 → 模块 ``` - Call count statistics / 调用次数统计 - Token consumption tracking / Token 消耗追踪 - Cost analysis / 费用统计分析 - Trend prediction / 趋势预测 ### 🔌 Hot-Swappable Skills / 技能热插拔 | Feature | Description | |---------|-------------| | Built-in Skills | 40+ open source skills / 40+ 开源技能 | | One-click Install | Install from marketplace / 从市场安装 | | Custom Development | YAML/Java dual mode / YAML/Java 双模式 | | Version Management | Skill version control / 技能版本控制 | ### 👥 PageAgent Deep Integration / PageAgent 深度嵌入 - Human-like role design / 拟人化角色设计 - Page-level embedding / 页面级嵌入 - Context awareness / 上下文感知 - Multi-Agent collaboration / 多 Agent 协作 ### 💾 Scene Group Persistence / 场景组持久化 | Feature | Description | |---------|-------------| | Auto-save | Automatic persistence on changes / 变更自动持久化 | | Auto-restore | Load on startup / 启动自动加载 | | YAML Format | Human-readable storage / 人类可读格式 | | Location | `~/.ooder/scene-groups/` | --- ## Documentation / 文档 ### User Docs / 用户文档 | Document | Description | |----------|-------------| | [Installation Guide](docs/INSTALL_GUIDE.md) | Detailed installation / 详细安装说明 | | [Changelog](CHANGELOG.md) | Version updates / 版本更新记录 | | [SE Activation Requirement](docs/se-activation-requirement.md) | SE SDK activation module spec / SE SDK激活模块规范 | ### Developer Docs / 开发文档 | Document | Description | |----------|-------------| | [Architecture](docs/ARCHITECTURE.md) | System architecture / 系统架构说明 | | [Contributing](docs/CONTRIBUTING.md) | Contribution guide / 贡献代码指南 | | [API Docs](http://localhost:8084/swagger-ui.html) | RESTful API documentation | --- ## Project Structure / 项目结构 ``` apex/ ├── src/main/ │ ├── java/net/ooder/mvp/ │ │ ├── ApexCoreApplication.java # Main entry / 主入口 │ │ ├── config/ # Configuration / 配置类 │ │ ├── controller/ # Controllers / 控制器 │ │ └── skill/scene/ # Core modules / 核心模块 │ │ ├── agent/ # Agent module │ │ ├── capability/ # Capability module │ │ ├── knowledge/ # Knowledge module │ │ └── llm/ # LLM module │ └── resources/ │ ├── static/ # Static resources │ ├── prompts/ # Prompt templates │ └── application.yml # Configuration ├── profiles/ # Profile configs │ ├── micro.json # Micro edition │ ├── small.json # Small edition │ └── large.json # Large edition ├── docs/ # Documentation ├── LICENSE # MIT License ├── README.md # This file └── CHANGELOG.md # Change log ``` --- ## Tech Stack / 技术栈 | Technology | Version | Description | |------------|---------|-------------| | Java | 21 | LTS version | | Spring Boot | 3.4.x | Core framework | | SE SDK | 3.0.1 | Scene Engine SDK | | GraalVM | 21+ | Native compilation (optional) | | SQLite | 3.x | Embedded database | | WebSocket | - | Real-time communication | | SpringDoc | 2.x | API documentation | | FastJSON2 | 2.x | JSON processing | --- ## Use Cases / 适用场景 ### 🏢 Intelligent Customer Service / 智能客服 Knowledge-enhanced customer service, 24/7 auto-response, reducing labor costs. ### 📚 Enterprise Knowledge Base / 企业知识库 Transform scattered documents into searchable knowledge, making AI the enterprise's "second brain." ### 📊 Intelligent Reports / 智能报表 Auto-generate daily, weekly, monthly reports, freeing from repetitive work. ### 🔄 Business Automation / 业务自动化 Workflow orchestration, automatic execution of repetitive tasks, improving team efficiency. ### 🤖 AI Assistant / AI 助手 Add AI assistants to business systems, enhancing user experience. --- ## Contributing / 贡献 We welcome all forms of contributions! / 我们欢迎所有形式的贡献！ ### Ways to Contribute / 贡献方式 - 🐛 Submit bug reports / 提交 Bug 报告 - 💡 Propose new features / 提出新功能建议 - 📝 Improve documentation / 改进文档 - 🔧 Submit code / 提交代码 ### Contribution Flow / 贡献流程 ```bash # 1. Fork project / Fork 项目 # 2. Create feature branch / 创建特性分支 git checkout -b feature/AmazingFeature # 3. Commit changes / 提交更改 git commit -m 'feat: add new feature' # 4. Push branch / 推送分支 git push origin feature/AmazingFeature # 5. Submit Pull Request / 提交 Pull Request ``` See [Contributing Guide](docs/CONTRIBUTING.md) for details. --- ## License / 开源协议 This project is licensed under the [MIT License](LICENSE). ``` MIT License Copyright (c) 2026 onecode Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. ``` --- ## Contact Us / 联系我们 | Channel | Info | |---------|------| | **Gitee** | https://gitee.com/ooderCN/apex | | **Team** | onecode | | **Email** | onecode@ooder.cn | ---
Apex —— 让 AI 能力像乐高一样自由组合
Apex — Combine AI capabilities like LEGO blocks
Made with ❤️ by onecode Team