OpenCompany

环境要求

• Windows / macOS（Apple Silicon 或 Intel）/ Linux x86_64 桌面系统，或可联网的服务器与无头机器
• 首次启动需要联网完成一次性初始化下载（约 1~2 分钟）
• 终端安装脚本会在缺失时自动安装 bun、Python 和 uv
• 源码运行需要 bun 1.4+ 与 Python 3.12
• Docker 自托管方式需要本机已安装 Docker 与 Docker Compose

安装与启动步骤

1. 1下载桌面安装包

   按操作系统下载对应安装包：Windows 用 exe，macOS 区分 Apple Silicon 与 Intel 的 dmg，Linux 用 AppImage 或 deb，链接始终指向最新 release。

2. 2安装并首次启动

   安装后打开应用，首次启动会自动完成一次性初始化下载（一到两分钟），随后进入 Home 页面。

3. 3连接 AI 提供方

   在 Settings > Connectors 中填入自己的 API Key，或使用本地模型；若未连接，Home 会主动提示你连接。

4. 4招聘第一个员工

   在 Home 中直接描述一份工作内容即可雇佣第一个 AI 员工，员工会在本机后台持续工作并自我改进。

5. 5查看示例工作流

   切换到 Dev 模式进入工作流编辑器，侧栏列有三个示例员工，打开即可了解团队是如何由多个智能体拼装而成的。

6. 6终端方式安装

   适用于服务器和无头机器：脚本会自动安装依赖并装好 opencompany 包，然后启动服务。

   curl -fsSL https://opencompany.sh/install.sh | bash
   company start

   复制

7. 7Docker 自托管部署

   克隆仓库后用 compose 从源码构建镜像并启动单个容器，数据保存在 opencompany-selfhost_data 卷中。

   git clone https://github.com/zeenie-ai/OpenCompany.git
   cd OpenCompany
   docker compose up -d --build

   复制

8. 8源码运行（贡献者）

   克隆仓库后执行构建与开发启动命令，需要本地已有 bun 1.4+ 与 Python 3.12。

   git clone https://github.com/zeenie-ai/OpenCompany.git
   cd OpenCompany
   bun run build
   bun run dev

   复制

关键配置

如何确认成功

桌面版启动后自动进入 Home 页面；终端与 Docker 方式在浏览器打开 http://localhost:5678，能注册 owner 账号即成功。

常见问题

注意事项

• 桌面构建尚未代码签名，macOS 与 Windows 首次运行都可能需要手动放行。
• 终端安装脚本区分平台：macOS/Linux 用 bash 脚本，Windows 用 PowerShell 脚本。
• 终端与 Docker 方式都使用 5678 端口，且数据默认只保存在本机。
• 源码运行需要 bun 1.4+ 与 Python 3.12，遇到问题可参考仓库中的 SETUP.md。