smixs/iva-agent

这是什么？

核心功能

• 01通过 Deepgram 转写语音消息，并借助模型的视觉能力描述图片。
• 02逐字保存每天的消息为 Markdown，并逐级汇总为周、月、年摘要。
• 03保留 CORE.md 文件，每次对话都会带上，提供持久上下文。
• 04使用 BM25 结合链接图重排进行记忆检索，可选向量搜索。
• 05管理任务、提醒和每日简报。
• 06通过 gws 命令行工具接入 Gmail、日历、云端硬盘、表格、文档和任务，并支持 MCP 服务器与技能扩展。

适用场景

• 几个月后快速找回与客户的约定内容。
• 把一段长语音转成任务清单、邮件草稿或会议卡片。
• 在 Telegram 中维护联系人与跟进事项的个人 CRM。
• 搭建一个数据留在自有服务器上的个人助手。

快速上手

1. 1

   从 BotFather 获取机器人令牌

2. 2

   克隆代码仓库

   git clone https://github.com/smixs/iva-agent.git ~/iva
3. 3

   在克隆目录中运行安装脚本并回答其问题

   cd ~/iva && bash install.sh
4. 4

   给你的机器人发消息,让向导完成设置

使用前须知

• !需要 Node.js 24 或更高版本,并且需要你自己维护一台服务器,自托管工作量较大。
• !需要模型服务商的 API 密钥或订阅,模型和语音转写调用会发送到你需付费的云端 API。
• !可选的用户机器人功能违反 Telegram 服务条款,可能导致账号受限或被封禁。

标签

常见问题

iva-agent 是什么？

可自托管的 Telegram AI 助手，把语音、图片和消息整理进 Markdown 记忆库，之后可检索回忆。 Iva 是一个运行在自有服务器上的 Telegram AI 助手。消息、语音、图片、PDF 和转发内容会以带日期的 Markdown 文件保存到兼容 Obsidian 的记忆库中，并逐步整理成联系人、项目、决策和笔记等结构化卡片。

iva-agent 可以免费使用吗？用的什么许可证？

iva-agent 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

iva-agent 还在维护吗？

活跃维护中。iva-agent 最近一次提交是在 2026年10月22日。

iva-agent 适合用来做什么？

几个月后快速找回与客户的约定内容。 把一段长语音转成任务清单、邮件草稿或会议卡片。 在 Telegram 中维护联系人与跟进事项的个人 CRM。 搭建一个数据留在自有服务器上的个人助手。

iva-agent 怎么安装和运行？

从 BotFather 获取机器人令牌 克隆代码仓库: git clone https://github.com/smixs/iva-agent.git ~/iva 在克隆目录中运行安装脚本并回答其问题: cd ~/iva && bash install.sh 给你的机器人发消息,让向导完成设置

在哪里获取 iva-agent？

源代码和安装说明在 GitHub 上：https://github.com/smixs/iva-agent