Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
7bdd96d
docs(readme): refresh news through v1.10.0
Code-MonkeyZhang Sep 19, 2026
a251f51
style: sync typography and spacing with design demo across shared scr…
Code-MonkeyZhang Sep 23, 2026
6ccce13
style: add sectioned left nav to settings page
Code-MonkeyZhang Sep 23, 2026
4e72dbb
feat: show storage paths and fix language matching in general settings
Code-MonkeyZhang Sep 23, 2026
a0e301a
feat: add cloned voice renaming and unify api key card
Code-MonkeyZhang Sep 23, 2026
f77ba2a
style: unify provider panel visuals with api key card
Code-MonkeyZhang Sep 23, 2026
a96a63f
style: replace in-card dividers with gap spacing across setting cards
Code-MonkeyZhang Sep 23, 2026
eedbb1c
style: refresh session sidebar header and gradient
Code-MonkeyZhang Sep 23, 2026
51da6b9
style: align primary color and add elevation tokens with design demo
Code-MonkeyZhang Sep 23, 2026
9b17d97
style: polish chrome details to match design demo
Code-MonkeyZhang Sep 23, 2026
ff4eb02
style: raise input box and make it permanently active
Code-MonkeyZhang Sep 23, 2026
b5ffe05
feat: collapsible session sidebar with animated resize handle
Code-MonkeyZhang Sep 23, 2026
cacebf1
style: anchor empty session prompt above center
Code-MonkeyZhang Sep 23, 2026
8ac4264
style: align sidebar and chat headers at 65px
Code-MonkeyZhang Sep 23, 2026
95dc659
chore: bump version to 1.10.1
Code-MonkeyZhang Sep 23, 2026
e7e835b
docs(readme): refresh readme for v1.10.1
Code-MonkeyZhang Sep 23, 2026
9f8fe08
docs(readme): refine header, screenshots and feature list
Code-MonkeyZhang Sep 23, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
64 changes: 44 additions & 20 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,44 +11,68 @@
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
![Platform](https://img.shields.io/badge/Platform-macOS%20%7C%20Windows-informational)
[![Release](https://img.shields.io/github/v/release/Code-MonkeyZhang/persona-agent?include_prereleases)](https://github.com/Code-MonkeyZhang/persona-agent/releases)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)

**An open-source personal AI companion you can fully customize**

[📥 Download](https://github.com/Code-MonkeyZhang/persona-agent/releases) · [🐛 Report a Bug](https://github.com/Code-MonkeyZhang/persona-agent/issues) · [🛒 Agent Marketplace](https://github.com/Code-MonkeyZhang/persona-agent-marketplace)

</div>

---

Persona is an open-source personal AI Agent chat platform that lets you give your agents custom personality, voice, and portraits.

Install agents, MCP tools, and Skills from the Agent Marketplace in one click.

## 📷 Preview
## 📷 Screenshots

<table>
<tr>
<td><img src="assets/screenshot-main.jpg" width="400" /></td>
<td><img src="assets/screenshot-companion.jpg" width="400" /></td>
<td align="center"><b>💬 A clean chat interface with a familiar messaging-app feel</b></td>
<td align="center"><b>🌸 Switch to the portrait view anytime, expressions follow the mood</b></td>
</tr>
<tr>
<td><img src="assets/preview-chat.jpg" width="400" /></td>
<td><img src="assets/preview-companion.jpg" width="400" /></td>
</tr>
<tr>
<td align="center"><b>🛒 One-click install of AI characters, skills, and tools from the built-in marketplace</b></td>
<td align="center"><b>🎨 Open the Agent editor anytime to customize portraits, voice, and prompts</b></td>
</tr>
<tr>
<td><img src="assets/preview-marketplace.jpg" width="400" /></td>
<td><img src="assets/preview-agent-editor.jpg" width="400" /></td>
</tr>
</table>

## ✨ Key Features
- **Multi-Agent Management** — Create multiple independent Agents with character settings, model configuration, MCP tools, Agent Skills, and conversation history
- **17 LLM Providers** — DeepSeek, MiniMax, Zhipu, Kimi, Moonshot, OpenAI, Anthropic, Google, OpenRouter, and more
- **Custom Agent Portraits** — Add custom character portraits and backgrounds. Agents automatically switch expressions based on conversation context
- **Voice Synthesis** — TTS voice synthesis powered by MiniMax API
- **MCP & Agent Skills** — Configure custom MCP tools and Agent Skills for each Agent, including OAuth-based MCP services (Notion, GitHub)
- **Agent Apps** — Install dedicated mini-apps for your Agent, interact via the app panel and receive app notifications
- **Remote Access** — Built-in Cloudflare Tunnel for connecting from the mobile app

## 📢 News
- **Long-Term Memory** — Conversations are summarized automatically and consolidated into long-term memory on a schedule, so agents remember you across sessions
- **Custom Character Portraits** — Assign character portraits and conversation backgrounds; agents switch expressions based on conversation mood
- **Custom Voice** — TTS replies powered by MiniMax, with preset voices and custom voice cloning from recordings
- **MCP & Agent Skills** — Assign MCP tools and Agent Skills to each agent individually, including OAuth-based MCP services (Notion, GitHub)
- **Agent Apps** — Install dedicated mini-apps for your Agent, interact via the app panel and receive app notifications
- **Mobile Remote Access** — Built-in Cloudflare Tunnel for connecting to your agent from the mobile app anytime

## 📢 Changelog
- 2026-09-23 — **v1.10.1**: app-wide visual refresh, collapsible session sidebar with animation and width memory, cloned voice renaming, permanently active input box.
- 2026-09-19 — **v1.10.0**: global Inter font and unified type scale, per-turn assistant message bubbles, redesigned provider config panel, edge-fade scroll indicators.
- 2026-09-09 — **v1.9.2**: desktop logs persisted to the user data directory for easier troubleshooting.
- 2026-09-08 — **v1.9.1**: interjections while generating, draggable session sidebar width, project adopted the MIT License.
- 2026-08-29 — **v1.9.0**: first-launch setup wizard with a preinstalled starter Agent, GLM-5.3-Flash and GLM-5.3-Highspeed model support.
- 2026-08-24 — **v1.8.0**: official brand icons for providers and models, bilingual voice preview texts, unified marketplace card heights.
- 2026-08-19 — **v1.7.1**: automatic retry on transient LLM connection errors, automatic fallback for invalid workspaces, message previews in the session list, GLM-5.3 support.
- 2026-08-17 — **v1.7.0**: Agent Apps — a new App tab in the marketplace for one-click install of mini-apps, with an app panel and app notifications.
- 2026-07-23 — **v1.6.5**: in-app update checker, macOS code signing and notarization, companion panel rebuilt as a sliding pane, abort generation support.
- 2026-07-19 — **v1.6.4**: Intel Mac support, QR scan-to-pair remote connection, Kimi K3 support, cross-fade pose transitions, redesigned thought-process timeline.
- 2026-07-04 — **v1.6.0**: merged multi-step thinking, persistent API error messages, Git Bash on Windows, one-click uv runtime download, optimistic chat loading.
- 2026-06-28 — **v1.5.0**: new Agent Marketplace for browsing and installing skills & MCP tools; unified HTTP error handling; design system rollout.
- 2026-06-23 — **v1.4.0**: redesigned desktop UI (TitleBar + dual sidebars), agent chat with multi-session management, dedicated skill/tool assignment views.

<details>
<summary>Earlier news</summary>

- 2026-07-19 — **v1.6.4**: Intel Mac support, QR scan-to-pair remote connection, Kimi K3 support, cross-fade pose transitions, redesigned thought-process timeline.
- 2026-07-04 — **v1.6.0**: merged multi-step thinking, persistent API error messages, Git Bash on Windows, one-click uv runtime download, optimistic chat loading.
- 2026-06-28 — **v1.5.0**: new Agent Marketplace for browsing and installing skills & MCP tools; unified HTTP error handling; design system rollout.
- 2026-06-23 — **v1.4.0**: redesigned desktop UI (TitleBar + dual sidebars), agent chat with multi-session management, dedicated skill/tool assignment views.
- 2026-06-04 — **v1.2.3**: fixed message leaking and cross-session voice playback on session switch; improved skill path resolution and system prompt editing.
- 2026-05-24 — **v1.2.1**: Windows platform support, bilingual (CN/EN) UI.
- 2026-05-20 — **v1.2.0**: agent portrait & background management, companion panel animations and window drag-region fixes.
Expand All @@ -66,11 +90,11 @@ Install agents, MCP tools, and Skills from the Agent Marketplace in one click.

This project supports macOS and Windows. Download the installer from [GitHub Releases](https://github.com/Code-MonkeyZhang/persona-agent/releases):

| Platform | File |
| ------------------- | --------------------------------- |
| macOS Apple Silicon | `Persona-mac-arm64-{version}.dmg` |
| macOS Intel | `Persona-mac-x64-{version}.dmg` |
| Windows x64 | `Persona-win-x64-{version}.exe` |
| Platform | Download |
| ------------------- | ---------------------------------------------------------------------------------------------------------------- |
| macOS Apple Silicon | [Download installer](https://github.com/Code-MonkeyZhang/persona-agent/releases) |
| macOS Intel | [Download installer](https://github.com/Code-MonkeyZhang/persona-agent/releases) |
| Windows x64 | [Download installer](https://github.com/Code-MonkeyZhang/persona-agent/releases) |

Open the DMG file and drag the app to Applications; on Windows, run the exe installer and follow the prompts.

Expand Down
65 changes: 45 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,42 +11,67 @@
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
![Platform](https://img.shields.io/badge/Platform-macOS%20%7C%20Windows-informational)
[![Release](https://img.shields.io/github/v/release/Code-MonkeyZhang/persona-agent?include_prereleases)](https://github.com/Code-MonkeyZhang/persona-agent/releases)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)

**一个完全可自定义的开源个人 AI 陪伴助手**

[📥 下载最新版本](https://github.com/Code-MonkeyZhang/persona-agent/releases) · [🐛 报告 Bug](https://github.com/Code-MonkeyZhang/persona-agent/issues) · [🛒 Agent 商城](https://github.com/Code-MonkeyZhang/persona-agent-marketplace)

</div>

---

Persona-agent 是一个开源的个人 AI Agent 聊天平台,让你能够完全自定义属于自己的 AI Agent,包括性格、声音和立绘形象,还支持从 Agent 商城一键安装 Agent、MCP 工具和 Skill。Persona-agent 期望创建一个适配LLM时代的人机关系的应用平台

## 📷 预览
## 📷 实机画面展示

<table>
<tr>
<td><img src="assets/screenshot-main.jpg" width="400" /></td>
<td><img src="assets/screenshot-companion.jpg" width="400" /></td>
<td align="center"><b>💬 清新的对话界面,模拟正常聊天App的体验</b></td>
<td align="center"><b>🌸 随时切换到立绘界面,表情会按照对话情绪切换</b></td>
</tr>
<tr>
<td><img src="assets/preview-chat.jpg" width="400" /></td>
<td><img src="assets/preview-companion.jpg" width="400" /></td>
</tr>
<tr>
<td align="center"><b>🛒 从内置商城一键安装AI角色以及技能和工具</b></td>
<td align="center"><b>🎨 随时进入Agent编辑器,从立绘、声线到提示词完全自定义</b></td>
</tr>
<tr>
<td><img src="assets/preview-marketplace.jpg" width="400" /></td>
<td><img src="assets/preview-agent-editor.jpg" width="400" /></td>
</tr>
</table>

## ✨ 核心功能
- **多 Agent 管理** — 创建多个独立 Agent, 角色设定、模型配置MCP、Agent Skill以及会话历史
- **支持 17 家 LLM 供应商** — DeepSeek、MiniMax、智谱、Kimi、月之暗面、OpenAI、Anthropic、Google、OpenRouter 等多供应商支持
- **自定义 Agent 形象界面** — 支持自定义Agent的角色立绘和背景,Agent 会根据对话自动切换表情
- **自定义 Agent 语音朗读** - 支持Minimax TTS API的语音合成回复
- **支持 MCP 与 Agent Skill** — 支持自定义给每个Agent自定义MCP工具和Agent Skill,同时支持需要OAuth的MCP服务 (Notion, Github)

- **长期记忆** — 会话自动总结,Agent 定期整理进长期记忆,跨会话记住你的偏好与正在做的事
- **自定义角色立绘** — 为 Agent 配置角色立绘与对话背景,Agent 根据对话情绪自动切换表情
- **自定义语音** — MiniMax TTS 驱动的语音合成回复,支持预设音色与录音克隆
- **MCP 与 Agent Skill** — 为每个 Agent 单独分配 MCP 工具与 Agent Skill,支持需要 OAuth 的 MCP 服务(Notion、GitHub)
- **Agent App** — 为 Agent 安装专属小应用,通过应用面板交互并接收应用通知
- **远程访问** — 内置 Cloudflare Tunnel,可以通过移动端App远程连接Agent
- **手机端远程访问** — 内置 Cloudflare Tunnel,移动端 App 可随时远程连接 Agent

## 📢 News
## 📢 更新日志

- 2026-09-23 — **v1.10.1**:全应用界面视觉升级、会话侧栏收合动画与宽度记忆、克隆音色重命名、输入框常驻激活态。
- 2026-09-19 — **v1.10.0**:全局 Inter 字体与统一字号体系、对话按轮次气泡重组、供应商配置面板重设计、边缘渐隐滚动提示。
- 2026-09-09 — **v1.9.2**:桌面端运行日志持久化到用户数据目录,问题排查有据可查。
- 2026-09-08 — **v1.9.1**:生成中插话、会话侧边栏宽度拖拽调整、项目采用 MIT License 开源。
- 2026-08-29 — **v1.9.0**:首次启动设置向导与预置初始 Agent、GLM-5.3-Flash 与 GLM-5.3-Highspeed 模型支持。
- 2026-08-24 — **v1.8.0**:供应商与模型官方品牌图标、语音试听文案中英双语、商城卡片高度统一。
- 2026-08-19 — **v1.7.1**:LLM 瞬时断连自动重试、无效工作空间自动回退、会话列表消息预览、GLM-5.3 支持。
- 2026-08-17 — **v1.7.0**:Agent App 体系上线 — 商城新增 App 标签页,一键安装专属小应用,支持应用面板交互与通知。
- 2026-07-23 — **v1.6.5**:应用内检查更新、macOS 安装包签名与公证、陪伴面板重构为滑出式、支持中止生成。
- 2026-07-19 — **v1.6.4**:Intel Mac 支持、扫码配对远程连接、Kimi K3 支持、立绘切换过渡动画、思考过程时间线重设计。
- 2026-07-04 — **v1.6.0**:思考过程合并展示、API 错误提示随会话持久化、Windows 端改用 Git Bash、uv 运行时一键下载、聊天乐观加载。
- 2026-06-28 — **v1.5.0**:新增 Agent 市场,应用内集中浏览和安装技能与 MCP 工具;统一 HTTP 错误处理;设计系统落地。
- 2026-06-23 — **v1.4.0**:全新桌面端 UI(TitleBar + 双侧边栏)、Agent 聊天与多会话管理、技能/工具独立分配视图。

<details>
<summary>Earlier news</summary>

- 2026-07-19 — **v1.6.4**:Intel Mac 支持、扫码配对远程连接、Kimi K3 支持、立绘切换过渡动画、思考过程时间线重设计。
- 2026-07-04 — **v1.6.0**:思考过程合并展示、API 错误提示随会话持久化、Windows 端改用 Git Bash、uv 运行时一键下载、聊天乐观加载。
- 2026-06-28 — **v1.5.0**:新增 Agent 市场,应用内集中浏览和安装技能与 MCP 工具;统一 HTTP 错误处理;设计系统落地。
- 2026-06-23 — **v1.4.0**:全新桌面端 UI(TitleBar + 双侧边栏)、Agent 聊天与多会话管理、技能/工具独立分配视图。
- 2026-06-04 — **v1.2.3**:修复会话切换时消息泄漏与跨会话语音播放,改进 Skill 路径解析与系统提示词编辑体验。
- 2026-05-24 — **v1.2.1**:Windows 平台支持、中英文双语界面。
- 2026-05-20 — **v1.2.0**:Agent 立绘与背景图管理、陪伴面板动画与窗口拖拽区域全面修复。
Expand All @@ -62,13 +87,13 @@ Persona-agent 是一个开源的个人 AI Agent 聊天平台,让你能够完

## 🚀 快速开始

本项目支持 macOS 和 Windows 平台. 前往 [GitHub Releases](https://github.com/Code-MonkeyZhang/persona-agent/releases) 下载对应平台的安装包:
本项目支持 macOS 和 Windows 平台。前往 [GitHub Releases](https://github.com/Code-MonkeyZhang/persona-agent/releases) 下载对应平台的安装包:

| 平台 | 文件 |
| ------------------- | --------------------------------- |
| macOS Apple Silicon | `Persona-mac-arm64-{version}.dmg` |
| macOS Intel | `Persona-mac-x64-{version}.dmg` |
| Windows x64 | `Persona-win-x64-{version}.exe` |
| 平台 | 下载 |
| ------------------- | ----------------------------------------------------------------------- |
| macOS Apple Silicon | [下载安装包](https://github.com/Code-MonkeyZhang/persona-agent/releases) |
| macOS Intel | [下载安装包](https://github.com/Code-MonkeyZhang/persona-agent/releases) |
| Windows x64 | [下载安装包](https://github.com/Code-MonkeyZhang/persona-agent/releases) |

macOS 打开 DMG 拖入 Applications 即可;Windows 运行 exe 安装程序按提示完成安装。

Expand Down
Binary file added assets/preview-agent-editor.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/preview-chat.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/preview-companion.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/preview-marketplace.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "persona-agent",
"version": "1.10.0",
"version": "1.10.1",
"private": true,
"license": "MIT",
"workspaces": [
Expand Down
2 changes: 1 addition & 1 deletion packages/desktop/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "persona-agent-desktop",
"version": "1.10.0",
"version": "1.10.1",
"description": "Persona Desktop - Electron GUI for Persona",
"type": "module",
"main": "./out/main/index.js",
Expand Down
Loading
Loading