LLMStack

环境要求

• 已安装 Python 及其包管理工具 pip（用于 pip install llmstack）
• Windows 用户需先在 WSL2 终端中操作，不能直接用原生命令行
• 可正常访问 localhost:3000 的本地浏览器
• 可选：OpenAI、Cohere、Stability 等模型供应商的 API Key

安装与启动步骤

1. 1Windows 先装 WSL2

   README 明确要求 Windows 用户使用 WSL2 安装 LLMStack，装好后进入 WSL2 终端再执行后续命令；Linux/macOS 可跳过此步。

2. 2安装 LLMStack

   通过 pip 从 PyPI 安装 llmstack 包，安装完成后会提供 llmstack 命令行入口。建议使用独立的 Python 虚拟环境。

   pip install llmstack

   复制

3. 3启动 LLMStack

   执行 llmstack 命令启动服务。首次运行会创建 ~/.llmstack 目录，并把数据库和配置文件放在其中。

   llmstack

   复制

4. 4浏览器访问控制台

   启动成功后程序会自动打开浏览器并指向 localhost:3000；若未自动弹出，可手动访问该地址。

5. 5修改默认密码

   使用默认管理员账号 admin / promptly 登录，随后立即在管理后台修改密码，避免保留公开的默认凭据。

6. 6配置模型密钥

   在 Settings 页面添加 OpenAI、Cohere、Stability 等供应商密钥；若要为实例所有用户提供默认密钥，可写入 ~/.llmstack/config 文件。

关键配置

如何确认成功

执行 llmstack 后浏览器自动打开或手动访问 localhost:3000 能出现登录页，用 admin / promptly 成功登录即启动成功。

常见问题

注意事项

• README 只提供了 pip 安装方式，未给出 Docker 部署命令，容器部署请以官方文档为准。
• 务必在首次登录后修改默认管理员密码（admin / promptly），否则实例存在安全风险。
• Windows 用户必须在 WSL2 环境中执行安装与启动命令。
• 首次运行生成的 ~/.llmstack 目录包含数据库和配置，迁移或备份时不要遗漏。