# TinyAgent

**Repository Path**: plankton12138/tiny-agent

## Basic Information

- **Project Name**: TinyAgent
- **Description**: 最小ReAct结构Agent。记录学习Agent的过程
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-20
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TinyAgent

一个符合 ReAct 模式的最小可行 AI Agent 系统。

## 特性

- **ReAct 循环**: 思考-行动-观察循环
- **工具调用**: 计算器、网页搜索
- **模型选择**: 根据复杂度自动选择 deepseek-chat/deepseek-reasoner
- **观察者模式**: 支持控制台和文件日志
- **REPL 界面**: 支持历史记录和优雅交互

## 安装

```bash
pip install -r requirements.txt
```

## 配置

复制 `.env.example` 为 `.env`，填写 API 密钥：

```bash
DEEPSEEK_API_KEY=your_key
TAVILY_API_KEY=your_key
```

## 运行

```bash
python main.py
```

## 测试

```bash
pytest tests/ -v
```

## 项目结构

```
tiny_agent/
├── main.py              # 入口 + REPL
├── config.py            # 配置加载
├── llm/                 # LLM 客户端
├── tools/               # 工具基类和内置工具
├── agent/               # ReAct 核心
├── utils/               # 日志/观察者
└── tests/               # 测试
```