GPT Academic 全面部署与扩展指南从安装、配置到自定义插件的完整实践【免费下载链接】gpt_academic为GPT/GLM等LLM大语言模型提供实用化交互接口特别优化论文阅读/润色/写作体验模块化设计支持自定义快捷按钮函数插件支持Python和C等项目剖析自译解功能PDF/LaTex论文翻译总结功能支持并行问询多种LLM模型支持chatglm3等本地模型。接入通义千问, deepseekcoder, 讯飞星火, 文心一言, llama2, rwkv, claude2, moss等。项目地址: https://gitcode.com/GitHub_Trending/gp/gpt_academic本篇技术指南基于 GPT Academic 项目的主 README日文版 docs/README.Japanese.md编写系统覆盖从环境安装、API 密钥配置、Docker 多方案部署到自定义快捷按钮、函数插件开发与主题切换的全部实践路径。读完本文你将能够独立完成该项目的本地与容器化部署理解其“环境变量 config_private.py config.py”的三级配置体系并具备基于仓库自带模板编写自己的 LLM 函数插件的能力。一、项目定位与核心功能总览GPT AcademicGPT 学术优化为 GPT/GLM 等大语言模型提供实用化交互接口特别优化论文阅读、润色、写作体验。项目采用模块化设计支持自定义快捷按钮与函数插件支持 Python/C 等项目剖析与自译解功能支持 PDF/LaTeX 论文翻译与总结并可并行问询多种 LLM 模型。重要说明本 README 日文版是由 GPT 翻译生成由项目自身的插件能力实现翻译结果并非 100% 准确以中文原版与实际代码为准。从 docs/README.Japanese.md 的功能清单可以看到项目的能力矩阵覆盖了从对话基础能力到科研全流程的多个维度功能⭐ 近年新增说明新模型接入百度千帆与文心一言、通义千问、上海 AI-Lab 书生、讯飞星火、LLaMa2、Azure、DALLE3 等校正、翻译、代码解释批量润色、翻译、论文语法错误查找、代码解释自定义快捷键支持自定义前缀/后缀快捷按钮模块化设计支持强大且可热重载的自定义插件程序解析[插件] 解析 Python/C/C/Java/Lua/... 项目树或让模型“自译解”本项目论文读取、翻译[插件] 翻译并总结 LaTeX/PDF 论文全文LaTeX 全文翻译、润色[插件] 对 LaTeX 论文进行翻译与润色批量注释生成[插件] 批量生成函数注释Markdown 翻译[插件] README 等 Markdown 文档的多语言互译对话分析报告生成[插件] 运行后自动生成总结报告PDF 论文全文翻译[插件] 抽取 PDF 论文标题与摘要并多线程翻译全文Arxiv 助手[插件] 输入 arXiv 论文 URL翻译摘要并下载 PDFLaTeX 论文批量润色[插件] 类似 Grammarly 地修正语法与拼写输出对照 PDFGoogle Scholar 集成[插件] 指定 Google Scholar 检索页面 URL让模型整理资料互联网信息聚合 GPT[插件] 从互联网获取信息并回答问题保持信息最新Arxiv 论文高精度翻译Docker[插件] 对 arXiv 论文进行超高质量翻译实时语音输入[插件] 异步监听语音、自动断句、自动寻找回答时机详见 docs/use_audio.md公式/图像/表格显示公式同时显示 TeX 源与渲染结果支持公式与代码高亮AutoGen 多智能体插件基于 Microsoft AutoGen 探索多智能体协作暗色主题在浏览器 URL 后追加/?__themedark即可切换多 LLM 模型支持GPT3.5、GPT4、ChatGLM2、MOSS 等模型可同时使用ChatGLM2 微调模型可加载微调模型使用并提供 ChatGLM2 微调辅助插件void-terminal 包 / Void Terminal 插件GUI 之外可从 Python 直接调用全部插件界面内可用自然语言直接驱动其他插件从源码结构看功能分区与界面严格对应main.py 中的gr.Blocks布局构建了“输入区 / 基础功能区 / 函数插件区”三大面板——基础功能区按钮来自 core_functional.py 的get_core_functions()函数插件区按钮来自 crazy_functional.py 的get_crazy_functions()插件可按Group分组对话/编程/学术/智能体筛选显示。二、安装方法一 直接运行Windows / Linux / MacOS2.1 下载项目git clone --depth1 https://github.com/binary-husky/gpt_academic.git cd gpt_academic2.2 配置 API 密钥在 config.py 中填写 API 密钥与其他设置。结合当前仓库的 config.py核心密钥配置项为# [step 1-1] 接入 OpenAI 模型家族可填多个 KEY英文逗号分隔 API_KEY sk-123456789xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx123456789 # [step 1-2] 接入通义家族 大模型服务平台百炼 DASHSCOPE_API_KEY # [step 1-3] 接入 deepseek-reasoner即 deepseek-r1 DEEPSEEK_API_KEY 多密钥共存时直接以逗号分隔写入API_KEY例如API_KEYopenai-key1,openai-key2,azure-key3,api2d-key4shared_utils/config_loader.py 中read_single_conf_with_lru_cache对API_KEY做了格式校验若不满足任何已知密钥格式会在启动日志中亮红提示。此外还支持在输入区临时输入 API 密钥后按回车提交即时生效刷新网页后失效该提示也见 main.py 顶部的help_menu_description。2.3 配置优先级环境变量 config_private.py config.pyconfig.py 文件头部注释与 shared_utils/config_loader.py 的加载逻辑共同定义了三级读取优先级环境变量形如GPT_ACADEMIC_API_KEYsk-xxx带前缀优先也可直接写API_KEYsk-xxx支持按默认值类型自动转型bool/int/float/str/dict/list见 config_loader.py 的read_env_variableconfig_private.py程序会优先检查config.py同目录下是否存在config_private.py强烈建议只复制需要修改的配置项到新文件便于项目升级时不丢失个人设置config.py仓库内的默认配置。环境变量的完整书写格式可参考 docker-compose.yml 与read_env_variable的 docstringconfig_loader.py# Windows cmd 示例两种方式等价带 GPT_ACADEMIC_ 前缀优先级更高 set USE_PROXYTrue set API_KEYsk-j7caBpkRoxxxxxxxxxxxxxxxxxxxxxxxxxxxx set proxies{http:http://127.0.0.1:10085, https:http://127.0.0.1:10085,} set AVAIL_LLM_MODELS[gpt-3.5-turbo, chatglm]2.4 安装依赖# 选项一熟悉 Python 环境Python 3.9 python -m pip install -r requirements.txt # 选项二使用 Anaconda conda create -n gptac_venv python3.11 # 创建 Anaconda 环境 conda activate gptac_venv # 激活环境 python -m pip install -r requirements.txt # 与 pip 安装步骤相同注意2023-11-07 起强调安装依赖时请选用requirements.txt中指定的版本。特别注意 Gradio 版本main.py 在启动时校验gr.__version__ 3.32.15不匹配会直接抛出ModuleNotFoundError提示必须通过pip install -r requirements.txt安装内置 Gradio 版本。2.5 可选步骤接入本地大模型ChatGLM / MOSS / RWKV【可选步骤一】添加清华 ChatGLM2 支持前提熟悉 PyTorch 与 NVIDIA GPUpython -m pip install -r request_llms/requirements_chatglm.txt若报错“不能正常加载 ChatGLM 的参数”1) 默认安装的是 torchCPU 版使用 CUDA 需重新安装 torchcuda 版2) 可修改 request_llms/bridge_chatglm.py 的模型精度将AutoTokenizer.from_pretrained(THUDM/chatglm-6b, ...)改为.../chatglm-6b-int4。【可选步骤二】添加复旦 MOSS 支持python -m pip install -r request_llms/requirements_moss.txt git clone --depth1 https://github.com/OpenLMLab/MOSS.git request_llms/moss # 须在项目根路径执行【可选步骤三】RWKV Runner 支持见项目 Wiki。【可选步骤四】确认config.py中AVAIL_LLM_MODELS包含目标模型例如AVAIL_LLM_MODELS [gpt-3.5-turbo, api2d-gpt-3.5-turbo, gpt-4, api2d-gpt-4, chatglm, moss]jittorllms 系列仅支持 Docker。当前仓库 config.py 的默认模型列表已扩展至 qwen-max、gpt-4o、glm-4、deepseek 系列等并支持one-api-*、vllm-*、ollama-*、openrouter-*前缀直接接入非标准方式部署的模型config.py 注释有示例。2.6 运行python main.py启动后 main.py 会以线程方式执行自动更新检查、模块预热tiktoken与自动打开浏览器最终经 shared_utils/fastapi_server.py 的start_app起服务端口由WEB_PORT决定-1表示随机空闲端口main.py。三、安装方法二 Docker 部署docs/README.Japanese.md 给出三套 Docker 方案操作方式统一为编辑 docker-compose.yml只保留目标方案的 service 段其余删除后执行docker-compose up。方案 0全功能部署——包含 CUDA 与 LaTeX 的大型镜像网络速度较慢或磁盘空间紧张时不推荐。方案 1仅在线模型ChatGPT 文心一言 星火等——对大多数人推荐另有带 LaTeX、带语音助手的变体镜像。若需使用 LaTeX 插件功能也可直接使用方案 0 或方案 4。方案 2ChatGPT ChatGLM2 MOSS LLaMA2 通义千问——需要熟悉 Nvidia Docker。各方案的镜像构建均由 GitHub Actions 自动产出对应 workflows 中的build-with-all-capacity.yml、build-without-local-llms.yml、build-with-latex.yml、build-with-audio-assistant.yml、build-with-chatglm.yml等。更多部署细节可参考仓库内的 docs/deployment/docker.md 与 docs/deployment/cloud_deploy.md。四、安装方法三 其他部署选项Windows 一键脚本不熟悉 Python 环境的 Windows 用户可从 Releases 页下载一键安装脚本安装无本地模型的版本脚本源自 oobabooga 社区的一键安装器项目。第三方 API / Azure使用文心一言、星火、Azure 等参考 docs/models/azure.md 与 docs/use_azure.mdconfig.py中AZURE_ENDPOINT/AZURE_ENGINE/AZURE_CFG_ARRAY对应单模型与多模型动态切换两种接法。云端服务器远程部署参考 docs/deployment/reverse_proxy.md 的远程部署指南配合 config.py 的USE_PROXY与proxies设置完成网络配置。FastAPI 子路径运行在http://localhost/subpath等二级路径下运行参考 docs/WithFastapi.mdconfig.py 提供CUSTOM_PATH选项。五、配置体系纵深解析config.py 共约 480 行文件尾部config.py附有“配置关联关系说明”ASCII 图是理解各配置项如何协同的最佳入口归纳如下在线模型 → 密钥映射模型前缀所需配置gpt-*OpenAI 系API_KEY 不常用的API_ORG、API_URL_REDIRECTazure-gpt-*单模型API_KEYAZURE_ENDPOINTAZURE_API_KEYAZURE_ENGINEazure-gpt-*多模型动态切换AZURE_CFG_ARRAYspark/sparkv2等讯飞星火XFYUN_APPIDXFYUN_API_SECRETXFYUN_API_KEYclaude-*ANTHROPIC_API_KEYstack-claudeSLACK_CLAUDE_BOT_IDSLACK_CLAUDE_USER_TOKENqianfan百度千帆BAIDU_CLOUD_API_KEYBAIDU_CLOUD_SECRET_KEYBAIDU_CLOUD_QIANFAN_MODELglm-4等智谱 AIZHIPUAI_API_KEYqwen-turbo等通义千问DASHSCOPE_API_KEYGeminiGEMINI_API_KEYone-api-*(max_token...)AVAIL_LLM_MODELSAPI_KEYAPI_URL_REDIRECT本地模型chatglm4/chatglm3/chatglm/chatglm_onnx/chatglmft/internlm/moss/jittorllms_*/deepseekcoder/qwen-local/llama2等对应 request_llms/ 目录下的各 bridge 文件本地模型的执行设备与量化由 config.py 的LOCAL_MODEL_DEVICEcpu/cuda与LOCAL_MODEL_QUANTFP16/INT4/INT8控制。界面体验类关键参数均可通过环境变量覆盖配置项默认值说明LAYOUTLEFT-RIGHT窗口布局TOP-DOWN切换上下布局main.py 中据此调整栅格DARK_MODETrue暗色/亮色模式前端支持动态切换THEMEDefault色彩主题AVAIL_THEMES可选Chuanhu-Small-and-Beautiful、High-Contrast等WEB_PORT-1网页端口-1 表示随机端口MAX_RETRY2OpenAI 不响应时的重试次数上限TIMEOUT_SECONDS30判定请求超时的秒数DEFAULT_WORKER_NUM8多线程插件中同时访问 OpenAI 的线程数免费 5 美元额度用户建议填 3AUTO_CONTEXT_CLIP_ENABLEFalse是否自动裁剪上下文见 config.py 的裁剪 token 触发阈值与分级比例表PLUGIN_HOT_RELOADFalse插件热加载开关临时替换 API_KEY 的机制在输入区输入临时密钥后提交前端将密钥经 cookie 机制随请求携带main.py 的说明文字明确“网页刷新后失效”与shared_utils/cookie_manager.py的 cookie 缓存实现相印证。六、高级用法 I自定义快捷按钮学术快捷键用文本编辑器打开 core_functional.py在get_core_functions()返回的字典中新增条目重启程序即可若按钮已存在仅修改前缀/后缀则支持热变更。条目结构与官方按钮完全一致以仓库内真实按钮为例core_functional.py学术语料润色: { # [1*] Prefix加在输入之前的提示词字符串示例按钮按中/英语境生成不同前缀 Prefix: ..., # [2*] Suffix加在输入之后的字符串可配合 Prefix 把输入用引号圈起 Suffix: r, # [3] Color按钮颜色可选默认 secondaryprimary/stop 对应 theme 的色相 Color: rsecondary, # [4] Visible按钮是否可见可选默认 True Visible: True, # [5] AutoClearHistory触发时是否清除历史可选默认 False AutoClearHistory: False, # [6] PreProcess文本预处理函数可选如清除换行符 PreProcess: None, # [7] ModelOverride强制该按钮使用指定模型可选 # ModelOverride: gpt-3.5-turbo, },README 日文版给出的自定义示例超级英译中超级英译中: { # 前缀加在输入之前。用于描述要求翻译、代码解释、润色等 Prefix: 将以下内容翻译成中文并逐个用 markdown 表格解释专业术语\n\n, # 后缀加在输入之后 Suffix: , },从 main.py 的源码可见基础功能区还会额外渲染NUM_CUSTOM_BASIC_BTN默认 4 个见 config.py个“自定义按钮”其前缀/后缀由前端 cookie 动态下发无需重启即可生效——这正是“已存在按钮支持热变更”的实现来源。七、高级用法 II函数插件crazy_functions定制项目提供强大且低门槛的函数插件机制具备一定 Python 基础后参照模板即可实现自己的插件功能详见 docs/customization/plugin_development.md 与 docs/customization/custom_buttons.md。仓库内置的插件类模板为 crazy_functions/plugin_template/plugin_class_template.py核心契约只有两个方法class GptAcademicPluginTemplate(): def define_arg_selection_menu(self): 返回插件参数菜单最多 8 个参数支持 string / dropdown 类型 raise NotImplementedError(You need to implement this method in your plugin class) def execute(txt, llm_kwargs, plugin_kwargs, chatbot, history, system_prompt, user_request): 插件主逻辑注意 execute 可能运行在不同线程中 不要在插件实例中存储会被多线程访问的状态 raise NotImplementedError参数菜单通过ArgPropertypydantic 模型描述标题、描述、默认值与类型并由get_js_code_for_generating_menu序列化后经 base64 注入前端生成参数输入框。新插件的注册流程参照 crazy_functional.py在 crazy_functions/ 下新建插件模块可复制 高级功能函数模板.py 或模板类在get_crazy_functions()中from crazy_functions.XXX import 你的函数在function_plugins字典中登记指定Group如对话|编程|学术|智能体用|分隔可归属多组、Function、颜色与高级参数说明等字段。[main.py](https://link.gitcode.com/i/b5e19806b03eb2a0bf6778d7df15b357#L302-L313)中的on_group_change逻辑解释了插件区 UI 的行为选择插件分组后AsButtonTrue的插件以按钮显隐方式刷新需高级参数的插件会同时出现在下拉列表中。开启 config.py 的PLUGIN_HOT_RELOADTrue后修改插件代码无需重启即热生效由 crazy_functional.py 引入的HotReload机制实现。八、多语言翻译本项目multi_language.py 的用法README 开头提到“可用 GPT 把本项目翻译成任意语言实验性功能”即本文所在文件的生成方式。multi_language.py 的使用步骤取自文件头 docstring修改config.py配置可用的LLM_MODEL与API_KEY修改脚本内LANG如Japanese并相应修改TransPrompt翻译指令运行python multi_language.py因模型偶有错漏需多次运行以提高覆盖率可用CACHE_ONLYTrue python multi_language.py仅使用已缓存的翻译映射在multi-language/LANG/目录查看翻译结果翻译映射缓存于docs/translate_*.json仓库内已有 docs/translate_english.json、docs/translate_japanese.json、docs/translate_std.json、docs/translate_traditionalchinese.json 等成品映射可在此修正错译并回馈上游。九、主题、版本分支与已知问题主题切换修改 config.py 的THEME选项Default/Chuanhu-Small-and-Beautiful/High-Contrast等更多主题可查阅 Gradio 主题商店浏览器 URL 追加/?__themedark可即时切换暗色主题对应 main.py 引入的js_code_for_toggle_darkmode与 themes/theme.js。另有 live2d 装饰ADD_WAIFU默认关闭资源见 themes/waifu_plugin/。开发分支master为主分支稳定版frontier为开发分支测试版。当前仓库 version 文件标注版本 4.00新增特性为“优化文件对话使用逻辑 新增速读论文”。已知问题原文档明示部分浏览器翻译插件会干扰本软件前端运行官方 Gradio 存在兼容性问题务必使用requirements.txt指定版本安装 Gradio对应 main.py 的硬校验。各文件功能索引项目中每个文件的功能说明可查阅 docs/self_analysis.md项目自译解报告随着版本演进可点击相关函数插件让 GPT 重新生成该报告这也是 crazy_functions/SourceCode_Analyse.py 的“解析项目本身”功能的典型用例。十、小结GPT Academic 的部署路径可以概括为三条主线源码直跑clone → 配 key → pip 装依赖 →python main.py、Docker 方案 0/1/2按算力与功能需求选择镜像、一键脚本与云平台面向无 Python 经验用户。其扩展能力则建立在清晰的分层上三级配置优先级保证了多环境部署的灵活性shared_utils/config_loader.py 的加载链可逐行验证core_functional.py的 Prefix/Suffix 字典实现了零代码的学术快捷键定制plugin_class_template.py的两个方法契约支撑了crazy_functions/下数十个可热重载的插件。按本文路径操作并对照所引用的源码文件即可完整复现从安装到深度定制的整个流程。【免费下载链接】gpt_academic为GPT/GLM等LLM大语言模型提供实用化交互接口特别优化论文阅读/润色/写作体验模块化设计支持自定义快捷按钮函数插件支持Python和C等项目剖析自译解功能PDF/LaTex论文翻译总结功能支持并行问询多种LLM模型支持chatglm3等本地模型。接入通义千问, deepseekcoder, 讯飞星火, 文心一言, llama2, rwkv, claude2, moss等。项目地址: https://gitcode.com/GitHub_Trending/gp/gpt_academic创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考