airunner

Q: 怎么加日语、韩语语音包？

默认 tts-python 不含 MeCab 语音包，装完系统依赖后执行 pip install -e ＂./services[openvoice_jp,openvoice_kr]＂。

本地离线跑 AI，画画聊天全搞定

开源 🏷️完全免费 🚫 站点已失效图像生成 🍴 复刻 104 🐛 待处理 44 👀 关注 10

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1318

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源桌面应用，本地离线运行，完全免费，无付费版本。

项目预览

项目数据

分类图像生成

开发团队Capsize-Games

官网地址https://airunner.art

GitHubhttps://github.com/Capsize-Games/airunner

定价模式🏷️完全免费

价格说明开源桌面应用，本地离线运行，完全免费，无付费版本。

访问状态🚫 站点已失效

是否开源是

开源协议GPL-3.0

主要语言Python

技术栈/模型ai,ai-art,art,asset-generator,chatbot,deep-learning,desktop-app,image-generation,mistral,multimodal,privacy,pygame,pyside6,python,self-hosted,speech-to-text,stable-diffusion,text-to-image,text-to-speech,text-to-speech-app

GitHub 星标★ 1318

上线时间2023-03-21 00:00:00

代码更新2026-11-04

仓库体积260.1 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数4

项目介绍

Airunner 是一个面向桌面端的离线 AI 推理引擎，集成了图像生成、实时语音对话、LLM 聊天机器人和自动化工作流。它解决的是用户对 AI 工具隐私和本地化控制的需求，无需云端依赖即可在本地运行多种模型。核心能力包括：基于 Stable Diffusion 的图像生成与编辑、支持 Mistral 等模型的本地聊天、实时语音交互（通过 pygame 实现音频处理）、以及可自定义的自动化任务流程。技术栈基于 Python 和 PySide（Qt 的 Python 绑定），提供图形化桌面界面，适合非技术用户和开发者。项目强调隐私保护，所有推理均在本地完成，数据不离开设备。目前处于成长阶段，社区活跃度中等。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1318

技术标签

ai ai-art art chatbot deep-learning

使用教程

难度：进阶约 30 分钟部署方式：Docker 8 步

环境要求

Linux 桌面环境（README 的安装示例基于 Ubuntu/Debian），Docker GUI 模式需要 X11
已安装 Docker 与 docker compose
手动 Python 安装需 Python 3.13+，推荐 pyenv + venv
使用 CUDA 加速需安装 NVIDIA CUDA 工具链（nvidia-cuda-toolkit）
磁盘空间充足，用于存放本地模型与构建 sidecar

安装与启动步骤

1获取项目代码

Docker 与脚本安装都需要在仓库目录内执行，先把仓库克隆到本地并进入目录。
```
git clone https://github.com/Capsize-Games/airunner.git
cd airunner
```
2Docker 启动图形界面

README 推荐方式。先放开 X11 访问权限，再启动 GUI 容器，退出后容器自动删除。
```
xhost +local:docker && docker compose run --rm airunner
```
3Docker 启动无头服务

以 headless 模式运行 HTTP API 服务；必须带 --service-ports，否则 8080 端口不会映射到宿主机。
```
docker compose run --rm --service-ports airunner --headless
```
4精简依赖重建镜像

按部署需要指定安装 profile 列表重建镜像，可去掉用不到的运行时依赖。
```
docker build --build-arg AIRUNNER_INSTALL_PROFILES=core,llm-native,stt-native -t airunner:headless .
```
5开发者脚本安装

适合基于仓库开发的场景，默认复用 ./venv，以可编辑模式安装并构建本地 sidecar。
```
./scripts/install.sh
```
6分布式角色安装

把守护进程与 GUI 客户端分开安装，可部署在不同机器上，分别指定 role。
```
./deployment/install_distributed.sh --role daemon
./deployment/install_distributed.sh --role gui-client
```

7安装系统依赖

手动安装路径的第一步，Ubuntu/Debian 下安装编译工具、音频、Qt 与语言包等系统库。

sudo apt update && sudo apt install -y build-essential cmake git curl wget pkg-config nvidia-cuda-toolkit pipewire libportaudio2 libxcb-cursor0 espeak espeak-ng-espeak qt6-qpa-plugins qt6-wayland libsentencepiece-dev mecab libmecab-dev mecab-ipadic-utf8 libxslt-dev mkcert

8PyPI 安装 GUI

先装 CUDA 12.9 版 torch 系列，再安装桌面 GUI 包与含模型运行时的服务包。

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu129
pip install "airunner"
pip install "airunner-services[headless]"

关键配置

配置项	必填	说明	示例
`AIRUNNER_INSTALL_PROFILES`	否	构建镜像时选择安装的运行时 profile，逗号分隔	`core,llm-native,stt-native`
`--role`	否	分布式安装时指定角色，守护进程或 GUI 客户端	`daemon`