Windows安装Octop实战PowerShell一键安装自托管AI助手的完整指南【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/OctopOctop是一个开源、自托管的 AI 助手支持多用户、多 Agent 协作拥有 Web 控制台、CLI、IM 通道和定时任务等能力。在 Windows 上安装它非常简单无需预装 Python一条 PowerShell 命令即可完成下载、环境创建和命令注册。本文带你走完安装、启动、登录控制台的全流程。 安装前准备3 项检查检查项要求说明操作系统Windows 10/11amd64 与 ARM64 均支持Python❌ 不需要脚本通过 uv 自动在~/.octop/下创建隔离的 Python 3.12 虚拟环境网络可访问外网用于下载安装脚本与依赖安装脚本源码见 install.ps1官方中文说明见 README_CN.md。 PowerShell 一键安装命令以普通用户打开 PowerShell开始菜单搜索PowerShell回车即可执行irm https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.ps1 | iex脚本自动完成了这 6 件事检测并安装 uv—— 若系统已有uv则直接复用创建隔离虚拟环境—— 在C:\Users\你\.octop\venv安装 Python 3.12不污染系统 Python从 PyPI 安装 octop 包并自动处理依赖生成命令包装器—— 创建~/.octop/bin/octop.ps1和octop.cmd写入用户 PATH—— 自动把~/.octop\bin加入用户环境变量自检验证—— 导入核心模块确认安装成功。 若系统 PowerShell 执行策略为Restricted脚本会自动为你切换为RemoteSigned仅限当前用户无需手动干预。 其他安装方式方式二cmd 批处理不习惯 PowerShell 时curl -fsSL https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.bat -o install.bat install.bat方式三本地脚本已克隆仓库时在仓库根目录执行powershell -ExecutionPolicy Bypass -File scripts/install.ps1常用参数作用示例-Version指定版本-Version 0.9.33-FromSource从源码安装配合-SourceDir 目录可指定本地源码-Extras附加组件-Extras browser安装 Playwright Chromium远程浏览器自动化完整选项见 scripts/README.md。✅ 验证安装是否成功重新打开一个新终端PATH 需要新会话才生效运行octop --version能看到版本号即安装成功。若提示octop 不是内部或外部命令说明 PATH 尚未生效关闭当前窗口重开即可。️ 初始化并启动 Web 控制台# 1. 初始化数据库与管理员账号交互式设置密码 octop init # 2. 前台运行API Web 控制台 octop run # 3. 或注册为 Windows 系统服务开机自启 octop service start随后打开浏览器访问http://127.0.0.1:8088用刚才设置的管理员账号登录即可看到 Web 控制台登录后可先在「设置 → 模型」中配置你的大模型供应商与 API Key配置完成后即可与 Agent 对话多 Agent、知识库、IM 通道与定时任务均可在控制台管理❓ 常见问题速查Q想装远程浏览器自动化能力安装时加参数即可若系统已装有 Chrome脚本会直接复用跳过 Chromium 下载irm https://finnie-1258344699.cos.ap-guangzhou.myqcloud.com/octop/install.ps1 | iex # 先安装 # 然后补装浏览器组件 ~\.octop\venv\Scripts\python.exe -m playwright install chromiumQ想升级到最新版octop updateQ数据存在哪里全部位于~/.octop/虚拟环境在venv/命令包装器在bin/默认数据库为octop.dbSQLite可选 PostgreSQL。备份该目录即可完整迁移。 相关资源安装脚本scripts/install.ps1、scripts/install.bat安装选项详解scripts/README.md完整用户指南docs/user-guide.md架构说明docs/architecture.md按以上步骤操作5 分钟内你就能在 Windows 上拥有一个数据完全留在本地的自托管 AI 助手 【免费下载链接】OctopA smarter, self-hosted AI assistant — multi-user, multi-agent.项目地址: https://gitcode.com/GitHub_Trending/oct/Octop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考