用途:在本机运行 cognee API 服务器,可同时启动 UI,并让 SDK 或 CLI 连接到该本地实例,而不是使用嵌入式本地模式。
主要能力与启动方式:从已安装的 cognee(不使用 Docker)运行 cognee-cli -ui,会启动完整本地栈:FastAPI 后端在 http://localhost:8000,UI 在 http://localhost:3000。需要在环境变量或 .env 中提供 LLM_API_KEY。交互式 API 参考位于 http://localhost:8000/docs,健康检查为 /health。若仅需 API 且用 Docker,则使用 cognee-docker 技能(预构建镜像 cognee/cognee:main 或在仓库中 docker compose up)。
认证姿态:ENABLE_BACKEND_ACCESS_CONTROL 决定行为。为 true(默认)时是多租户,每次 API 调用都要求认证,并按用户加数据集隔离数据库。为 false 时是单用户本地模式,无认证,共享本地数据库,适合个人开发服务器,绝不适合对外暴露。访问控制开启时 REQUIRE_AUTHENTICATION=false 会被忽略;要关闭认证必须设置 ENABLE_BACKEND_ACCESS_CONTROL=false。
连接客户端:SDK/CLI 连接服务器可用 cognee-cli serve --url http://localhost:8000(本地实例)、cognee-cli serve(cognee 云,设备流程)、cognee-cli serve --logout(断开)。Python 中为 await cognee.serve(url="http://localhost:8000")。HTTP 主要路由位于 /api/v1/,记忆 API 包括 remember(含 remember/entry)、recall、improve、forget;sessions 覆盖会话记忆;datasets、users、visualize 负责其余部分。旧的 add、cognify、search、memify、delete 路由仍存在,是记忆路由底层所调用者(可查看 cognee/api/client.py 中注册的路由,或在运行中的服务器上访问 GET /openapi.json)。注意没有 /api/v1/feedback 路由,反馈存在于 CLI 命令和 SDK 中,不通过 HTTP 暴露。
无完整 UI 时可视化图:from cognee.api.v1.visualize import visualization_server,shutdown = visualization_server(port=8080),该调用是同步的并返回一个关闭可调用对象。
故障排查:8000 端口被占用则停止其他服务或改映射(compose 中 "8080:8000")。每次调用返回 401/403 说明处于多租户模式,需认证或设置 ENABLE_BACKEND_ACCESS_CONTROL=false 后重启。recall/search 返回 [] 而不报错,是权限过滤后的结果,检查调用用户的数据集访问权限。
限制:资料未提供更多部署规模、性能或平台支持信息。