Cortx
安全可控的 AI Agent 运行时 — Harness Agent 架构 + Agentic Loop 引擎
Cortex = 大脑皮层。如同大脑皮层负责感知推理、血脑屏障严格过滤、海马体持久记忆 — Cortex Agent 将 Agentic Loop（推理）、PolicyEngine（安全）、Memory（记忆）融为一体。
双语言实现
| Python | TypeScript | |
|---|---|---|
| 位置 | python/cortex_agent/ |
src/ |
| 工具数 | 43 | 43 |
| 安装 | pip install cortx |
npm install -g @chnaicorp/cortx |
| CLI 命令 | ctx |
ctx |
💡 PyPI:
pip install cortx，npm:npm install -g @chnaicorp/cortx。运行只需ctx
快速开始
# Python (3 字母包名)
pip install cortx
ctx
# TypeScript
npm install -g @chnaicorp/cortx
ctx
ctx # 交互 REPL
ctx -q "hello" # 单次查询
ctx --model pro # 指定模型
# 单次查询
ctx -q "用 Python 写斐波那契函数"
🎯 Agent 自主开发 Demo
给 Agent 一句话指令，它自主完成项目规划、架构设计、前后端编码、依赖安装、编译验证、运行调试全流程，0 人工干预。
🛒 企业级购物网站 — cortx-demo-shop-app
| 指标 | 数据 |
|---|---|
| 源文件数 | 33 个 |
| 总代码行数 | 2,612 行 |
| 技术栈 | React + Vite + Express + TypeScript + SQLite + JWT |
| Agent 续行轮次 | 3 轮，182 步 |
| 人工干预 | 0 次 |
# 复现 Agent 自主开发过程
ctx --mode yolo --long --max-rounds 0 -q "请开发设计一个企业级购物网站，完整项目包含：
1.后端(Node.js+Express+TypeScript) RESTful API(商品列表、商品详情、购物车、订单、用户认证JWT)，
SQLite数据库含products/users/carts/orders表，密码bcrypt加密，中间件CORS/错误处理/JWT验证。
2.前端(React+Vite+TypeScript) 首页商品展示、商品详情页、购物车管理、用户登录注册、订单提交。
3.数据库：SQLite自动建表+种子数据至少10个商品。"
👉 查看完整项目代码: github.com/CHNAICORP/cortx-demo-shop-app
🧱 打砖块游戏 — cortx-demo-breakout
| 指标 | 数据 |
|---|---|
| 源文件数 | 1 个 (单文件 HTML5) |
| 总代码行数 | 574 行 |
| 技术栈 | HTML5 Canvas + 原生 JavaScript + CSS3 |
| 依赖 | 0 (零依赖、零构建) |
| 人工干预 | 0 次 |
# 复现 Agent 自主开发过程
ctx -q "用 HTML5 Canvas 做一个打砖块 Breakout 游戏，单文件 index.html，包含：
多关卡、计分、生命系统、粒子特效、鼠标+键盘+触摸控制、霓虹风格UI"
👉 查看游戏源码: github.com/CHNAICORP/cortx-demo-breakout · 🎮 直接打开即玩
🎮 AI 游戏开发 SaaS 平台 — gamespark
使用 Cortx Agent + LingClaw ADE 协同开发完成的完整 SaaS 平台。
| 指标 | 数据 |
|---|---|
| 源文件数 | 36 个 |
| 技术栈 | React 18 + TypeScript + Vite 5 + Tailwind CSS 3 + Express.js + JWT |
| 核心功能 | 用户认证、三级订阅、AI 工具集 API、在线游戏体验馆 |
| 开发方式 | Cortx Agent (代码生成) + LingClaw ADE (IDE 可视化) 协同开发 |
| 人工干预 | 仅需求描述，编码全自动化 |
👉 查看完整项目代码: github.com/CHNAICORP/gamespark
设计哲学
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
│ Think │ → │ Guard │ → │ Act │ → │ Reflect │
│ (LLM流式)│ │(Policy) │ │(Executor)│ │(步数收敛)│
└──────────┘ └──────────┘ └──────────┘ └──────────┘
| 原则 | 说明 |
|---|---|
| Agent 自主决策 | 不注入行为指令，Agent 从工具结果中自行推理 |
| 完整中介 | 所有工具调用必经 PolicyEngine 4 级审计 |
| Share-nothing 隔离 | 每实例独立 work_dir / executor / observer |
项目结构
ctx/
├── python/cortex_agent/ # Python 包
│ ├── cortex_agent.py # Agentic Loop 核心引擎
│ ├── policy.py # PolicyEngine 安全策略
│ ├── llm.py # LLM Provider (DeepSeek/OpenAI)
│ ├── tools.py # 核心工具 (25)
│ ├── tools_mcp.py # MCP 客户端 + 注册表
│ ├── tools_browser.py # CDP WebSocket 浏览器
│ ├── tools_computer.py # 桌面控制
│ ├── tools_network.py # 代理/镜像
│ ├── tools_rag.py # RAG 知识检索
│ ├── main.py # CLI 入口
│ ├── terminal.py # 流式终端
│ ├── memory.py # 记忆/会话
│ ├── config.py # 配置加载
│ └── skills.py # 技能系统
│
├── src/ # TypeScript 包
│ ├── core/ # 核心引擎
│ ├── tools/ # 工具模块 (7 文件)
│ └── cli/ # CLI 入口
│
├── cortex_workspace/ # 运行时工作区
├── CORTEX.md # 项目知识库
├── pyproject.toml # Python 包配置
├── package.json # npm 包配置
├── tsconfig.json # TypeScript 配置
└── PUBLISH.md # 发布指南
💡 想看 Agent 能做什么？ 查看 Demo 项目展示 或直接访问 cortx-demo-shop-app
43 个工具
| 分类 | 工具 |
|---|---|
| 文件 | list_directory read_file write_file edit_file glob grep diff_files file_ops read_json csv_query |
| 执行 | run_shell_command run_python execute_sql_query python_lint |
| 网络 | web_search web_fetch http_request set_proxy unset_proxy show_proxy |
| 记忆 | remember_fact recall_fact forget_fact ask_user |
| 任务 | task_create task_list task_update |
| MCP | mcp_list_servers mcp_list_tools mcp_call_tool mcp_registry mcp_install mcp_quick |
| 浏览器 | browser_navigate browser_snapshot browser_screenshot |
| 桌面 | computer_screenshot computer_click |
| 镜像 | pip_mirror npm_mirror |
| RAG | search_knowledge rebuild_knowledge_index |
| 时间 | get_current_time |
REPL 命令
| 命令 | 功能 |
|---|---|
/help |
显示帮助 |
/context |
上下文容量 + 缓存命中率 |
/kb |
查看知识库 CORTEX.md |
/goal [目标] |
设置/查看持久化目标 |
/plan [描述] |
进入规划模式 |
/skills |
列出所有技能 |
/skill <name> |
调用技能 |
/mode [s|a|y] |
切换权限模式 (Shift+Tab) |
/model [pro] |
切换模型 |
/tools |
列出工具 |
/trace /audit |
审计追踪 |
/memory |
查看记忆 |
/sessions |
列出会话 |
@filename |
文件引用 |
/init |
初始化项目 |
权限模式
| 模式 | 行为 |
|---|---|
standard 🛡️ |
SAFE 自动 / WRITE 区内 / SYSTEM 需确认 |
auto ✏️ |
自动批准编辑 + SYSTEM 放行 |
yolo ⚠️ |
全部放行 (CI/CD) |
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
cortx-2.5.1.tar.gz
(106.0 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
cortx-2.5.1-py3-none-any.whl
(111.8 kB
view details)
File details
Details for the file cortx-2.5.1.tar.gz.
File metadata
- Download URL: cortx-2.5.1.tar.gz
- Upload date:
- Size: 106.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
91fb0ea95bdbcddbf6dab746e46a46792016bc244ae18bfcdd9d3807b260dc5f
|
|
| MD5 |
18da88945af7d81a97c10641209c4588
|
|
| BLAKE2b-256 |
bfaa4eb423d2c69d7065febcaad4a8e72640d1c6cdbc86ab4564c97e38630d47
|
File details
Details for the file cortx-2.5.1-py3-none-any.whl.
File metadata
- Download URL: cortx-2.5.1-py3-none-any.whl
- Upload date:
- Size: 111.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bb33dcfdf47523f9e0c4de7e82628c7efdb56e7c4ef43a696e3a3cd8b272ad1c
|
|
| MD5 |
cd98f21a8820e744f831e6b4ebb0ecfd
|
|
| BLAKE2b-256 |
e41eac935e03d3aa4a43f9477907d1028e2f6bec260c9758b123942aca9c56f2
|
