# agent-runtime

**Repository Path**: xpnb/agent-runtime

## Basic Information

- **Project Name**: agent-runtime
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-09
- **Last Updated**: 2026-07-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Kylin Agent Runtime


**Kylin Agent Runtime 是基于 Hermes 改进的自进化智能体运行时。** 本项目在 Hermes 基础上继续改进主干与分支协同方法、记忆能力、自进化约束、过程详细显示等核心体验，后续也将持续演进。它内置学习闭环——从经验中创建技能，在使用中改进技能，主动持久化知识，搜索过往对话，并在跨会话中逐步构建对你的深度理解。可以在 $5 的 VPS 上运行，也可以在 GPU 集群上运行，或者使用几乎零成本的 Serverless 基础设施。它不绑定你的笔记本——你可以在 Telegram 上与它对话，而它在云端 VM 上工作。

## 安装

推荐使用 `uv` 创建虚拟环境并以可编辑模式安装本项目。

```bash
git clone https://gitee.com/clxf66/agent-runtime.git
cd agent-runtime

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv .venv --python 3.11
source .venv/bin/activate
uv pip install -e ".[all]"
```

如果你已经有 `uv` 和 Python 3.11，可以直接从创建虚拟环境开始。

## 开发安装

开发或运行测试时安装开发依赖：

```bash
git clone https://gitee.com/clxf66/agent-runtime.git
cd agent-runtime

uv venv .venv --python 3.11
source .venv/bin/activate
uv pip install -e ".[all,dev]"
```

## 更新

进入项目目录后拉取最新代码并重新安装：

```bash
git pull
source .venv/bin/activate
uv pip install -e ".[all]"
```

如果依赖锁文件发生变化，建议同步锁定依赖：

```bash
uv sync --all-extras
```

## 测试

运行默认测试：

```bash
scripts/run_tests.sh
```

或在已激活虚拟环境中直接运行：

```bash
python -m pytest tests/ -q
```

## 许可证

MIT — 详见 [LICENSE](LICENSE)。