ChrisVip001/joyczl-agent

这是什么？

核心功能

• 01可通过终端 REPL、浏览器控制面板，或 Telegram、Discord、微信、飞书网关对话。
• 02记忆分为三类：可检索的事实、带日期的情节记录和可复用的 Skills。
• 03内置笔记、日历、网页搜索、文件读取和网页抓取工具，并支持 MCP 服务器。
• 04命令执行经过沙箱与白名单限制，且需显式开启。
• 05客户端通过 JSON-RPC 与内核通信，SQLite 状态由单一进程独占管理。

适用场景

• 在自己的电脑上运行私人助手，把笔记、记忆和日历数据留在本地。
• 通过 Telegram 或 Discord 与智能体对话，同时状态数据保存在本机。
• 研究以 Rust 实现的智能体内核，并通过 JSON-RPC 接口供其他客户端调用。
• 使用本地 Ollama 模型作为助手的大模型，避免数据上传云端。

快速上手

1. 1

   在 joy-rs 目录中构建 Rust 项目

   cd joy-rs && cargo build
2. 2

   使用模型提供方和 API 密钥启动终端 REPL

   JOY_PROVIDER=deepseek DEEPSEEK_API_KEY=… ./target/debug/joy
3. 3

   或者启动控制面板，访问 http://localhost:7777

   JOY_PROVIDER=deepseek DEEPSEEK_API_KEY=… ./target/debug/joy dashboard

使用前须知

• !需要使用 Cargo 从源码构建，因为目前尚未在 PyPI 或 npm 发布任何包。
• !需要 LLM 提供方的 API 密钥，或本地 Ollama 环境，才能正常回答。
• !Discord、微信和 Lark 网关从未连接过真实平台。

收录于专题

标签

常见问题

joyczl-agent 是什么？

一个本地优先的个人助手，Rust 内核负责推理循环、记忆与工具，并提供 TypeScript 聊天网关和控制面板。 Joy 是一个在用户本机运行的个人助手。推理循环、记忆、工具与状态存储由 Rust 实现，TypeScript 提供浏览器控制面板，并接入 Telegram、Discord、微信和飞书等聊天网关。Python SDK 是对 `joy app-server` 所暴露 JSON-RPC 接口的轻量封装，所有客户端都通过同一进程访问 SQLite 状态库。

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

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

joyczl-agent 还在维护吗？

活跃维护中。joyczl-agent 最近一次提交是在 2026年11月4日。

joyczl-agent 适合用来做什么？

在自己的电脑上运行私人助手，把笔记、记忆和日历数据留在本地。 通过 Telegram 或 Discord 与智能体对话，同时状态数据保存在本机。 研究以 Rust 实现的智能体内核，并通过 JSON-RPC 接口供其他客户端调用。 使用本地 Ollama 模型作为助手的大模型，避免数据上传云端。

joyczl-agent 怎么安装和运行？

在 joy-rs 目录中构建 Rust 项目: cd joy-rs && cargo build 使用模型提供方和 API 密钥启动终端 REPL: JOY_PROVIDER=deepseek DEEPSEEK_API_KEY=… ./target/debug/joy 或者启动控制面板，访问 http://localhost:7777: JOY_PROVIDER=deepseek DEEPSEEK_API_KEY=… ./target/debug/joy dashboard

在哪里获取 joyczl-agent？

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