如何在 Windows 上用 launch-windows.ps1 快速安装并启动 Odysseus 原生服务【免费下载链接】odysseusSelf-hosted AI workspace.项目地址: https://gitcode.com/gh_mirrors/ody/odysseus如果你想在 Windows 上以原生方式运行 Odysseus不经过 Docker仓库提供的 launch-windows.ps1 是一条单命令路径它自动创建 venv、安装依赖、执行首次 setup首次运行会打印 admin 临时密码然后直接启动服务。前提是本机装有 Python 3.11完成后你打开http://localhost:7000用终端里打印的临时密码登录再进入Settings配置模型、搜索和邮件。准备条件Python 3.11。脚本按顺序探测解释器先尝试py -3.13、py -3.12、py -3.11再回退到 PATH 上的python必须满足 3.11。全部找不到时脚本会报错退出提示从 https://www.python.org/downloads/ 安装 Python 3.11 后重跑。Git用于克隆仓库。Git for Windows可选核心应用chat、agent、memory、documents、email、calendar、deep research完全原生运行不需要它但完整的Cookbook后台模型下载和 agent shell 工具依赖bash.exe。没装 Git Bash 时脚本会打印一段黄色 NOTE 提醒你但不会中断。本机 CUDA 环境可选如果存在C:\Program Files\NVIDIA GPU Computing Toolkit\CUDA脚本会自动把CUDA_PATH指向其中最新的带bin的版本供 GPU llama-cpp-python 导入使用。用一条命令完成安装与启动在 PowerShell 中执行git clone https://github.com/odysseus-dev/odysseus.git cd odysseus powershell -ExecutionPolicy Bypass -File .\launch-windows.ps1脚本内部依次做五件事每一步都有前缀的输出方便你定位卡在哪一步检查并选定 Python 3.11 解释器创建venv已存在则跳过升级 pip 并pip install -r requirements.txt——首次运行需要几分钟执行setup.py创建数据目录、初始化数据库、生成.env和 admin 用户启动uvicorn服务默认监听127.0.0.1:7000。整个脚本是幂等的可以安全重跑——已存在的 venv、依赖和 setup 状态会被跳过适合依赖更新或重装后恢复环境。脚本接受两个参数见文件头部的 Usage 注释powershell -ExecutionPolicy Bypass -File .\launch-windows.ps1 -Port 7000 -BindHost 127.0.0.1-Port默认7000传给 uvicorn 的端口。脚本同时会把APP_PORT写入环境变量因为internal_api_base()、companion pairing 和 MCP OAuth 回调都读取APP_PORT来构造 URL只传 uvicorn 端口会导致它们仍然假设7000-BindHost默认127.0.0.1监听地址。本地自用保持默认即可。验证启动结果首次 setup 时Odysseus 会创建一个 admin 账户用户名默认为admin除非设置了ODYSSEUS_ADMIN_USER并在终端打印一个临时密码。验证步骤在浏览器打开http://localhost:7000用刚才终端里打印的临时密码登录登录后到Settings里把密码改掉模型、搜索、邮件等其余配置也都在Settings里完成。能登录进Settings即说明 venv、依赖、数据库和服务端口都工作正常。手工执行同一流程可选替代路径如果不想用脚本文档给出了等价的手工步骤git clone https://github.com/odysseus-dev/odysseus.git cd odysseus py -3.11 -m venv venv venv\Scripts\Activate.ps1 pip install -r requirements.txt python setup.py python -m uvicorn app:app --host 127.0.0.1 --port 7000注意如果python指向的是旧版本解释器venv 那一步改用py -3.12或其他已安装的 3.11 版本。手工方式与脚本的差异在于没有自动设置CUDA_PATH也没有-Port/-BindHost的统一处理。在局域网或 Tailscale 上暴露服务可选分支默认监听127.0.0.1其他设备无法访问。要暴露到受信任的 LAN/VPN例如 Tailscale用启动器的-BindHost参数powershell -ExecutionPolicy Bypass -File .\launch-windows.ps1 -BindHost 0.0.0.0这里有一个 Windows 原生路径特有的坑启动器不读取.env里的APP_BIND/ODYSSEUS_HOST只改.env不会生效服务仍留在 loopback手工 uvicorn 命令则对应--host 0.0.0.0。文档同时要求只在受信任网络绑定0.0.0.0、保持AUTH_ENABLEDtrue不要把端口直接暴露到公网。Windows 上的已知限制与常见坑本地 GPU 推理的运行环境vLLM/SGLang 的本地 GPUserving需要 Linux/WSL2。在 Windows 本机跑本地模型文档给出的最简路径是装 Ollama然后在 Settings 里把端点指向http://localhost:11434/v1。.env被 Notepad 保存成 UTF-8 BOM这是文档点名的 Windows 专属陷阱。BOM 会把首行键变成AUTH_ENABLED导致AUTH_ENABLEDfalse等设置被静默忽略表现为你改了配置却不生效。Odysseus 以utf-8-sig读取.env可以容忍 BOM但稳妥做法是把.env以UTF-8 无 BOM重新保存VS CodeSave with Encoding → UTF-8。依赖安装慢脚本明确提示首次运行pip install可能持续几分钟中途没有输出是正常的真正失败时脚本会打印ERROR: Dependency install failed并让你回滚查看 pip 的报错。可选依赖requirements-optional.txt里的功能包如faster-whisper、markitdown默认不安装需要时自行pip install -r requirements-optional.txt与本文的启动主路径无关。更完整的配置变量APP_PORT、AUTH_ENABLED、LOCALHOST_BYPASS等和安全注意事项见 docs/setup.md 的 Configuration 与 Security Notes 章节所有用户数据落在data/目录备份恢复参见 backup-restore.md。【免费下载链接】odysseusSelf-hosted AI workspace.项目地址: https://gitcode.com/gh_mirrors/ody/odysseus创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考