# oagent

**Repository Path**: dolphin_flow/oagent

## Basic Information

- **Project Name**: oagent
- **Description**: A sandboxed local Ollama Personal Knowledge Agent with write-only capabilities: it can append memories and save files, but is prohibited from reading or modifying existing local files.
- **Primary Language**: Rust
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-05
- **Last Updated**: 2026-03-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# oagent

基于 Ollama 的 AI Agent 命令行工具

## 简介

oagent 是一个强大的命令行 AI Agent，集成 Ollama 大语言模型，提供智能对话、内存管理、文件操作和 Bash 集成等功能。

## 特性

- 🤖 **智能对话** - 基于 Ollama 的自然语言交互
- 💾 **记忆系统** - 持久化存储对话上下文和自定义记忆
- 📁 **文件操作** - 写入文件
- 💻 **Bash 集成** - 直接在终端执行命令
- 🔄 **模型管理** - 灵活切换不同的 AI 模型

## 快速开始

### 安装 (Debian 12 下成功测试，MAC应该能用（没测试），Windows可以通过Document+vibe code做小部分修改)

```bash
# 克隆或复制项目
git clone https://gitee.com/dolphin_flow/oagent.git
cd oagent

# 构建项目
cargo build --release

# 运行安装脚本 (需要 sudo)
sudo ./install.sh
```

### 卸载

```bash
sudo ./uninstall.sh
```

## 基本用法

### 启动 Agent

```bash
oagent
```

或指定工作目录：

```bash
oagent /path/to/directory
```

### 常用命令

| 命令 | 说明 |
|------|------|
| `/?` | 显示帮助信息 |
| `/list` | 列出可用模型 |
| `/mo <编号>` | 切换 AI 模型 |
| `/mod <编号>` | 设置默认模型 |
| `/m <内容>` | 添加记忆 |
| `/mem` | 列出所有记忆 |
| `/memtoggle` | 切换记忆开关 |
| `/f` | 保存当前对话 |
| `/b` | 进入 Bash 交互模式 |
| `/q` | 退出程序 |

## 示例会话


## 架构概述

- **AgentState** - 状态管理
- **Ollama 集成** - LLM API 调用
- **Memory System** - 记忆持久化
- **File Operations** - 文件存储
- **Bash Integration** - 命令执行

## 文档

详细文档请参阅 [DOCUMENTATION.md](./DOCUMENTATION.md)

## 开源许可

本项目基于 GPL-3.0 许可证开源，详见 [LICENSE](./LICENSE) 文件。

## 问题反馈

如遇问题，请提交 Issue 或查阅文档中的 Q&A 部分。