尽管官方的DeepWiki已经能够满足我的大部分需求，但是对于一些github以外的仓库，或者私有仓库，还是得本地部署。
我选择了deepwiki-open这一项目来部署。首先自然是将仓库clone到本地，然后创建一个新的venv：
git clone https://github.com/AsyncFuncAI/deepwiki-open.git cd deepwiki-open python3 -m venv venv . venv/bin/activate
安装依赖
python -m pip install poetry==2.0.1 && poetry install -C api
在这一步我就遇到了问题。新版本的faiss-cpu无法安装，需要手动安装1.8.0的版本：
pip3 install faiss-cpu==1.8.0
其次，似乎1.8.0的faiss不兼容numpy 2.x，需要降回1：
pip3 uninstall numpy pip3 install numpy==1.26.4
配置API
在DeepWiki的项目根目录创建一个.env文件，内容如下，根据具体情况修改值：
GOOGLE_API_KEY=your_google_api_key OPENAI_API_KEY=your_openai_api_key # Optional: Use Google AI embeddings (recommended if using Google models) DEEPWIKI_EMBEDDER_TYPE=google # Optional: Add this if you want to use OpenRouter models OPENROUTER_API_KEY=your_openrouter_api_key # Optional: Add this if you want to use Azure OpenAI models AZURE_OPENAI_API_KEY=your_azure_openai_api_key AZURE_OPENAI_ENDPOINT=your_azure_openai_endpoint AZURE_OPENAI_VERSION=your_azure_openai_version # Optional: Add Ollama host if not local. default: http://localhost:11434 OLLAMA_HOST=your_ollama_host
如果需要使用其他兼容OpenAI API的网站，加上这一行：
OPENAI_BASE_URL=https://custom-api-endpoint.com/v1
启动
后端：
python3 -m api.main
前端：
npm install npm run dev
进入浏览器，输入http://localhost:3000/，即可正常进入DeepWiki。
如果前端出现错误，删除node_modules文件夹和package-lock.json文件，重新执行上述两条命令。