Metadata-Version: 2.4
Name: fastmind
Version: 0.1.0
Summary: 具身智能多Agent系统框架
Project-URL: Homepage, https://github.com/fastmind-ai/fastmind
Project-URL: Documentation, https://fastmind.ai/docs
Project-URL: Repository, https://github.com/fastmind-ai/fastmind
Author: FastMind Team
License-Expression: MIT
Keywords: agent,ai,embodied-ai,graph,llm
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Provides-Extra: all
Requires-Dist: mypy>=1.0.0; extra == 'all'
Requires-Dist: openai>=1.0.0; extra == 'all'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'all'
Requires-Dist: pytest-cov>=4.0.0; extra == 'all'
Requires-Dist: pytest>=7.0.0; extra == 'all'
Requires-Dist: python-dotenv>=1.0.0; extra == 'all'
Requires-Dist: ruff>=0.1.0; extra == 'all'
Provides-Extra: dev
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Provides-Extra: examples
Requires-Dist: openai>=1.0.0; extra == 'examples'
Requires-Dist: python-dotenv>=1.0.0; extra == 'examples'
Description-Content-Type: text/markdown

# FastMind 框架

具身智能多 Agent 系统框架

## 核心特性

- **轻量高效**: 核心代码不超过 8000 行，不依赖 LangChain、LangGraph 等框架
- **事件驱动**: 基于 asyncio 的事件驱动架构，支持千级并发会话
- **具身原生**: 内置感知循环，支持传感器、定时器等外部驱动
- **Human-in-the-loop**: 支持人工确认和中断
- **开发者友好**: 类似 FastAPI 的装饰器模式

## 快速开始

```python
from fastmind import FastMind, Graph, Event
from fastmind.contrib import FastMindAPI

app = FastMind()

@app.agent(name="chat")
async def chat(state, event):
    state["reply"] = f"收到: {event.payload.get('text')}"
    return state

graph = Graph()
graph.add_node("chat", chat)
graph.set_entry_point("chat")
app.register_graph("main", graph)

async def main():
    api = FastMindAPI(app)
    await api.start()
    await api.push_event("user1", Event("msg", {"text": "你好"}, "user1"))
    # ...
    await api.stop()
```

## 目录结构

```
fastmind/
├── core/           # 核心模块
│   ├── app.py      # FastMind 主类
│   ├── graph.py    # Graph 类
│   ├── event.py    # Event 类
│   ├── state.py    # State 类
│   ├── tool.py     # 工具系统
│   ├── node.py     # Agent 节点
│   ├── engine.py   # 执行引擎
│   └── perception.py  # 感知循环
├── contrib/        # 扩展模块
│   └── api.py      # FastMindAPI
├── examples/       # 示例代码
└── tests/         # 测试代码
```

## 示例

```bash
cd fastmind
PYTHONPATH=. python3 examples/simple_chat.py
```

## 文档

- [快速入门](quickstart.md)
- [核心概念](core_concepts.md)
- [API 参考](api_reference.md)
