Skip to content

Greatbeing/yogacara-agent

Repository files navigation

🌀 Yogacara Agent:基于唯识理论的进化型 AI Agent 框架

License Python LangGraph CI

将佛教唯识学“八识”认知架构工程化为可计算、可演化、可对齐的 AI Agent 系统。支持快慢双循环决策、三性认知过滤、在线策略进化与跨仿真平台适配。

🏗️ 架构总览

graph LR
  A[环境/数字孪生] --> B(前五识: 多模态感知)
  B --> C(第六识: 意识规划/LLM/工具路由)
  C --> D(第七识: 末那控制器/元认知/安全过滤)
  D --> E[执行器/动作输出]
  E --> F[反馈流: Reward/评价/自检]
  F --> G(第八识: 阿赖耶记忆/种子库/在线熏习)
  G -. 种子生现行 .-> C
  G -. 慢循环巩固 .-> G
  D -. 转识成智: 反思/换向/对齐 .-> C
Loading

✨ 核心特性

  • 🧠 八识计算映射:感知→意识→末那调控→阿赖耶演化闭环
  • 快慢双循环:毫秒级决策 + 异步记忆巩固/参数微调
  • 🛡️ 三性判别机制:遍计所执(幻觉过滤) / 依他起(因果追踪) / 圆成实(价值对齐)
  • 🔌 生产级底座:LangGraph 状态机 / FastAPI / Ray Serve / vLLM / K8s+Helm
  • 📊 学术可验证:在线实验流水线 / 95%置信区间 / 消融模板 / 一键出图
  • 🌐 跨域适配:ROS2 / Unity ML-Agents / Isaac Sim 统一环境契约

🚀 5分钟快速体验

方式 A — Web 可视化(推荐新手)

pip install streamlit
streamlit run demo_app.py
# 打开 http://localhost:8501
  • 实时网格世界 + 八识数据流
  • 种子记忆状态可视化
  • 末那识拦截事件
  • 四智指标仪表盘

方式 B — 终端演示(无需任何依赖)

python run_demo.py                          # 单轮演示
python run_demo.py -n 10 -s 60            # 10轮批量实验
python run_demo.py --max-steps 20         # 短跑(20步)
  • UTF-8 编码(Windows GBK 兼容)
  • ASCII 网格 + 实时评分
  • 四智近似指标输出

方式 C — 标准测试

python -m yogacara_agent.yogacara_test     # 9项核心测试
pytest tests/                              # 完整测试套件

🚀 快速开始

方式一:使用外部 API(推荐,无需本地 GPU)

git clone https://github.com/Greatbeing/yogacara-agent.git
cd yogacara-agent

# 配置 API Key(以 DeepSeek 为例)
export LLM_BASE_URL="https://api.deepseek.com/v1"
export LLM_API_KEY="sk-your-api-key"
export LLM_MODEL="deepseek-chat"

# 安装轻量依赖(仅需 openai, langgraph 等小库)
pip install openai langgraph langchain-core fastapi python-dotenv

# 运行测试
python src/yogacara_test.py

优势

  • ✅ 无需安装 transformers/vllm 等大型库
  • ✅ 504MB 存储限制下完美运行
  • ✅ 成本可控(¥10 内完成百次实验)
  • ✅ 内置降级保护(API 失败自动切换启发式算法)

详见:外部 API 调用指南

方式二:本地完整安装(需 GPU + 大存储)

git clone https://github.com/Greatbeing/yogacara-agent.git
cd yogacara-agent
pip install -e ".[all]"  # 包含 transformers, vllm, peft 等
python src/yogacara_test.py  # MVP 验证

📦 模块说明

模块 路径 功能
演示入口 run_demo.py 终端演示脚本(无 GBK 问题)
Web 演示 demo_app.py Streamlit 可视化界面
MVP验证 src/yogacara_test.py 零依赖八识闭环跑通
生产编排 src/yogacara_langgraph.py 异步双循环+工具路由
LLM接入 src/llm_planner.py Qwen/Llama结构化输出+降级
记忆持久化 src/milvus_memory.py HNSW索引/元数据过滤/批量熏习
在线对齐 src/online_alignment.py DPO+LoRA+EWC防遗忘
安全加固 src/security/ 注入防御/沙箱/限流/记忆守卫
数字孪生 src/env_adapters/ ROS2/Unity/Isaac统一接口
实验自动化 src/exp_automator.py 多轮并行/置信区间/论文图表
云原生部署 k8s/, helm/ HPA扩缩容/ConfigMap热更/Ray拓扑

📖 详细文档

🤝 贡献指南

详见 CONTRIBUTING.md

📜 许可证

Apache License 2.0。商业使用请保留版权声明。

📚 Citation

@software{yogacara_agent_2026,
  title = {Yogacara Agent: A Cognitive Evolution Framework for AI Agents},
  author = {JueXin (Greatbeing)},
  year = {2026},
  url = {https://github.com/Greatbeing/yogacara-agent},
  license = {Apache-2.0}
}

About

A cognitive evolution framework for AI Agents based on Yogacara (Consciousness-Only) theory

Topics

Resources

License

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages