DeepWiki项目本地AI模型部署指南：基于Ollama的完整实践

最新推荐文章于 2025-06-12 20:43:31 发布

符汝姿

最新推荐文章于 2025-06-12 20:43:31 发布

阅读量360

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00802/article/details/148487753

DeepWiki项目本地AI模型部署指南：基于Ollama的完整实践

deepwiki-open Open Source DeepWiki: AI-Powered Wiki Generator for GitHub Repositories 项目地址: https://gitcode.com/gh_mirrors/de/deepwiki-open

前言

在当今AI技术快速发展的时代，如何在保证数据隐私的同时利用AI能力成为开发者关注的重点。DeepWiki项目通过集成Ollama本地AI模型，为开发者提供了一种全新的代码文档生成解决方案。本文将详细介绍如何利用Ollama在本地环境中部署和使用DeepWiki项目。

核心优势

DeepWiki结合Ollama的方案具有以下显著优势：

数据隐私保护：所有代码分析和文档生成过程完全在本地完成，无需将敏感代码上传至云端
成本节约：避免了使用商业API（如OpenAI）产生的高昂费用
离线可用：无需互联网连接即可使用全部功能
模型定制：可根据项目需求自由选择和切换不同规模的AI模型

环境准备

第一步：安装Ollama

Ollama是一个轻量级的本地AI模型运行框架，支持跨平台部署：

Windows系统安装

从Ollama官网获取Windows安装包
运行安装程序并按照向导完成安装
安装完成后，Ollama会自动在后台运行（可在系统托盘中查看）

macOS系统安装

下载macOS版本的Ollama安装包
将Ollama应用拖拽至Applications文件夹
从启动台或Applications文件夹中启动Ollama

Linux系统安装 执行以下命令即可完成安装：

curl -fsSL https://ollama.com/install.sh | sh

第二步：下载AI模型

DeepWiki需要两个核心模型来支持其功能：

代码理解模型（nomic-embed-text）：用于分析代码结构和语义
文档生成模型（qwen3:1.7b）：用于生成高质量的文档内容

在终端中执行以下命令下载模型：

ollama pull nomic-embed-text
ollama pull qwen3:1.7b

DeepWiki项目部署

基础环境配置

获取DeepWiki项目源代码
创建并配置环境变量文件（.env）：

PORT=8001
# 如需远程连接Ollama服务可配置此项
OLLAMA_HOST=http://localhost:11434

安装后端依赖并启动服务：

pip install -r api/requirements.txt
python -m api.main

安装前端依赖并启动界面：

npm install
npm run dev

Docker部署方案（推荐）

对于希望快速部署的用户，可以使用预配置的Docker方案：

构建Docker镜像：

docker build -f Dockerfile-ollama-local -t deepwiki:ollama-local .

运行容器（基础模式）：

docker run -p 3000:3000 -p 8001:8001 --name deepwiki \
  -v ~/.adalflow:/root/.adalflow \
  -e OLLAMA_HOST=your_ollama_host \
  deepwiki:ollama-local

运行容器（本地代码库分析模式）：

docker run -p 3000:3000 -p 8001:8001 --name deepwiki \
  -v ~/.adalflow:/root/.adalflow \
  -e OLLAMA_HOST=your_ollama_host \
  -v /path/to/your/repo:/app/local-repos/repo-name \
  deepwiki:ollama-local

注意：Apple Silicon芯片的Mac用户会自动使用ARM64优化版本，获得更好的性能表现。

使用指南

访问本地服务：http://localhost:3000
输入目标代码库地址（支持Git平台或本地路径）
勾选"使用本地Ollama模型"选项
点击"生成文档"按钮

系统将自动完成以下流程：

使用nomic-embed-text模型分析代码结构
使用qwen3:1.7b模型生成文档内容
所有处理均在本地完成

高级配置

模型切换

DeepWiki支持灵活更换不同规模的AI模型，修改api/config/generator.json文件：

"generator_ollama": {
    "model_client": OllamaClient,
    "model_kwargs": {
        "model": "qwen3:1.7b",  // 可替换为其他模型
        "options": {
            "temperature": 0.7,
            "top_p": 0.8,
        }
    },
}

常用模型对比：

| 模型名称 | 大小 | 速度 | 质量 | 适用场景 | |---------|------|------|------|----------| | phi3:mini | 1.3GB | 快 | 良好 | 小型项目/快速测试 | | qwen3:1.7b | 3.8GB | 中等 | 优秀 | 默认选择/平衡方案 | | llama3:8b | 8GB | 慢 | 极佳 | 复杂项目/深度分析 |