GPT Academic 技术指南基于官方文档解析 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 仓库中的官方文档 docs/README.Italian.md项目多语言 README 的意大利语版本由项目自带的 GPT 翻译插件生成展开完整覆盖该文档中的核心内容安装方式直接运行、Docker、其他部署、三层配置优先级机制、快捷键自定义与函数插件体系、版本演进与分支策略。读完后你可以独立完成该项目的部署理解 config.py 的配置读取链路并能为自己新增“学术快捷键”和功能插件。一、项目定位与功能总览GPT Academicgpt_academic是一个为 GPT/GLM 等大语言模型提供实用化交互接口的项目针对论文阅读、润色、写作场景做了深度优化。从 docs/README.Italian.md 的功能矩阵来看其核心能力可以归纳为以下几类能力类别具体功能模型接入支持 OpenAI 家族GPT3.5/GPT4/Azure、清华 ChatGLM、复旦 MOSS、通义千问、文心一言/百度千帆、讯飞星火、LLaMA2、智谱、DALLE3 等支持多 API-KEY 共存与负载均衡文档处理PDF/LaTeX 全文翻译与校对多线程、文档解读与摘要生成、Arxiv 论文翻译与下载代码处理代码审查/翻译/语法纠错/一键解释Python/C/C/Java/Lua 等项目结构分析self analysis扩展体系模块化设计支持自定义快捷按钮与强类型函数插件插件支持热更新智能体多模型并行问询、AutoGen 多智能体插件、虚空终端自然语言调用任意插件交互体验公式同时以 tex 源码与渲染形式展示、代码高亮、深色/浅色主题、实时语音对话、Live2D 桌面宠物可选该文档同时给出了一条重要实践提示安装依赖时应选用requirements.txt中指定的版本安装命令为pip install -r requirements.txt项目自身的逐文件功能说明沉淀在 docs/self_analysis.md自译解报告中此外项目还内置了一个自我剖析插件可以调用 GPT 随时重新生成该报告。二、安装方式一直接运行Windows / Linux / MacOS这是文档推荐的主安装路径共四步。1. 获取代码git clone --depth1 https://gitcode.com/GitHub_Trending/gp/gpt_academic.git cd gpt_academic2. 配置 API_KEY 与其他参数在 config.py 中填写 API 密钥及各项配置。该文件头部注释明确声明了配置的读取规则读取优先级环境变量 config_private.py config.py文档特别建议使用config_private.py管理私有配置程序会先检查同目录下是否存在名为config_private.py的私有配置文件并用其中的值覆盖config.py中的同名配置。推荐的实践是新建config_private.py仅把改动过的配置项从config.py复制过去避免把密钥混在公共配置里。这一优先级在源码中得到直接印证。shared_utils/config_loader.py 中的read_single_conf_with_lru_cache按三级回退顺序取配置先读环境变量支持GPT_ACADEMIC_前缀或直接变量名见 shared_utils/config_loader.py失败则importlib动态导入config_private模块取同名属性再失败才回落到config模块的默认值。值得注意的实现细节环境变量值会参照config.py中同名默认值的类型进行转换——布尔值只接受字面量True/False字典和列表用eval解析。这也解释了为什么 docker-compose.yml 中的环境变量要写成字符串化的 Python 字面量如AVAIL_LLM_MODELS: [gpt-3.5-turbo, gpt-4] 。另一个来自文档的实用技巧当需要临时替换API_KEY 时无需改配置文件直接在聊天输入区粘贴新的API_KEY值并按回车即可生效该提示同样出现在 shared_utils/config_loader.py 的启动日志中。3. 安装依赖# 方案一直接使用 pip要求 python 3.9 python -m pip install -r requirements.txt # 网络不佳时可临时更换镜像源 # python -m pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/ # 方案二使用 Anaconda 建立独立环境 conda create -n gptac_venv python3.11 conda activate gptac_venv python -m pip install -r requirements.txt如果还要启用本地模型后端清华 ChatGLM2 / 复旦 MOSS / RWKV Runner需要额外安装对应依赖前提是具有 Python PyTorch 基础与较高端显卡# 可选步骤一支持清华 ChatGLM2 python -m pip install -r request_llms/requirements_chatglm.txt # 可选步骤二支持复旦 MOSS python -m pip install -r request_llms/requirements_moss.txt git clone --depth1 https://github.com/OpenLMLab/MOSS.git request_llms/moss # 在项目根目录下执行 # 可选步骤三确保 config.py 的 AVAIL_LLM_MODELS 包含所需模型 AVAIL_LLM_MODELS [gpt-3.5-turbo, api2d-gpt-3.5-turbo, gpt-4, chatglm, moss, jittorllms_rwkv, jittorllms_pangualpha, jittorllms_llama]文档还给出了一条 ChatGLM2 排错经验若报错无法加载 ChatGLM 参数(1) 默认安装的是 torchCPU 版要用 CUDA 需卸载后重装 torchCUDA 版(2) 显存不足时可把 request_llms/bridge_chatglm.py 中AutoTokenizer.from_pretrained(THUDM/chatglm-6b, ...)换成chatglm-6b-int4量化版本。4. 启动python main.py启动后会通过 Gradio 拉起 Web 界面浏览器可直接访问。界面布局由 config.py 的LAYOUT控制LEFT-RIGHT左右布局或TOP-DOWN上下布局切换后重启程序即可。三、安装方式二Docker 部署Docker 路径面向希望免本地环境搭建的用户。docker-compose.yml 内预置了多套部署方案文档说明的用法是只保留你要的方案、删掉其余方案然后执行docker-compose up。方案镜像内容适用场景方案零gpt_academic_full_capability全能力大镜像含 CUDA 与 LaTeX需要 Arxiv 翻译等完整能力网速慢、磁盘小、无显卡者不推荐方案一gpt_academic_nolocalllms仅在线模型ChatGPT/文心/星火等文档标注推荐大多数人选此项方案二gpt_academic_chatglm_moss含 ChatGLM2 MOSS LLaMA2 通义等本地模型需要 Nvidia Docker 显卡运行时从 docker-compose.yml 可见其端口暴露的两种机制方法一Linuxnetwork_mode: host与宿主机网络融合默认配置方法二全平台端口映射ports: - 12345:12345注意宿主机端口必须与容器内WEB_PORT环境变量一致。方案二中若要使用 GPU需开启被注释的 Nvidia 显卡运行时配置runtime: nvidia或deploy.resources.reservations.devices并把LOCAL_MODEL_DEVICE设为cuda。文档另提示如需 LaTeX 插件能力可直接使用方案零或方案四的镜像。对应的 Dockerfile 构建配方在仓库 docs/ 目录下以GithubAction*系列文件组织例如 docs/GithubActionNoLocal 对应方案一的无本地模型镜像。四、安装方式三其他部署选项文档还列出了若干补充部署途径Windows 一键脚本不熟悉 Python 环境时可从项目 Release 页面下载由 oobabooga 提供的一键执行脚本安装不含本地模型的版本第三方 API 接入Azure、文心、讯飞星火等第三方 API 的配置方法参见 wiki 的项目配置说明仓库中 docs/models/ 目录提供了 OpenAI、Azure、中转 API、本地模型等模型接入文档如 docs/models/azure.md云服务器远程部署参见 wiki 的云服务器部署指南仓库内对应 docs/deployment/cloud_deploy.md其他平台/方式Sealos 一键部署、WSL2 部署、以及通过 FastAPI 让服务运行在子路径如http://localhost/subpath下——子路径方式详见 docs/WithFastapi.md配合 config.py 的CUSTOM_PATH选项实现。五、关键配置项速览结合 config.py 源码与文档描述最相关的核心配置项如下均可被环境变量或config_private.py覆盖配置项默认值说明API_KEY占位符支持多个 KEY 用英文逗号分隔如sk-key1,sk-key2,azure-key3多 KEY 自动负载均衡LLM_MODEL/AVAIL_LLM_MODELSgpt-3.5-turbo-16k等默认模型必须包含在可用模型列表中可用模型含 qwen、gpt-4o、glm-4、deepseek、dashscope 系列等USE_PROXY/proxiesFalse代理开关与地址端口格式[协议]://[地址]:[端口]proxies单独生效会被 shared_utils/config_loader.py 拦截THEME/AVAIL_THEMESDefault界面主题文档提到可选Chuanhu-Small-and-Beautiful当前还内置High-Contrast及 Gradio 主题商店主题LAYOUTLEFT-RIGHT左右 / 上下两种窗口布局WEB_PORT-1随机端口与 Docker 端口映射必须对应DARK_MODETrue深浅色模式文档提示也可在浏览器 URL 末尾追加/?__themedark临时切换深色主题DEFAULT_WORKER_NUM8多线程插件中同时访问 OpenAI 的线程数文档给出经验值免费额度用户填 3绑卡用户可填 16 以上ADD_WAIFUFalse是否加载 Live2D 装饰对应themes/waifu_plugin/目录AUTHENTICATION[]用户名密码列表用于多人访问控制此外API_URL_REDIRECT可用于把 OpenAI API 地址重定向到自建反代文档标注为高危设置常规不要修改check_proxy.py 是项目自带的代理连通性自检脚本。六、进阶用法一自定义学术快捷键这是文档Advanced Usage的核心内容。打开 core_functional.py在get_core_functions()返回的字典中追加一个条目重启程序即可生成新按钮若按钮已存在仅修改前缀/后缀文案可热更新无需重启。高级中-英翻译: { # 前缀加在你的输入之前。例如描述你的要求翻译、解释代码、润色等 Prefix: 请把下列文本翻译成中文并用 markdown 表格逐一解释其中使用的技术术语:\n\n, # 后缀加在你的输入之后。例如配合前缀把输入内容用引号圈起来 Suffix: , },从 core_functional.py 的现有实现可以看到每个按钮完整支持七个可选字段Prefix/Suffix包裹用户输入的首尾提示词必填Color按钮颜色primary/secondary/stop对应主题中的色板可选默认 secondaryVisible按钮是否可见默认 TrueAutoClearHistory触发时是否清空历史对话默认 FalsePreProcess文本预处理函数默认 None例如可写函数去除换行符ModelOverride强制该按钮使用指定模型默认沿用全局模型。仓库中已内置的学术语料润色总结绘制脑图自动生成 mermaid flowchart、查找语法错误等按钮均是这一机制的实例——脑图按钮的 Suffix 甚至内嵌了一段完整的 mermaid 提示词模板见 core_functional.py。七、进阶用法二函数插件体系文档将模块化设计、支持热更新插件列为项目卖点之一并指引读者查阅插件开发指南仓库内对应 docs/customization/plugin_development.md。插件开发只需 Python 基础知识模板位于 crazy_functions/plugin_template/plugin_class_template.py项目内置插件则分布在crazy_functions/目录下例如crazy_functions/Latex_Function.pyLaTeX 翻译/校对crazy_functions/Arxiv_Downloader.pyArxiv 论文下载与翻译crazy_functions/PDF_Translate.pyPDF 全文多线程翻译crazy_functions/Void_Terminal.py虚空终端——用自然语言理解用户意图并自动调用其他插件文档示例输入调用插件翻译一篇 PDF 文档地址是 ...再点击虚空终端按钮插件注册入口为 crazy_functional.py。界面中只有高亮的插件按钮支持读取文件部分插件收在插件区的下拉菜单中。新插件一律通过 pull request 合入。八、多语言机制multi_language.py 与本文档的来历docs/README.Italian.md 开头声明其由 GPT项目自带插件翻译而成、并非 100% 可靠这正对应 multi_language.py 的能力用 LLM 把整个项目的字符串翻译成任意语言。其工作流见文件头注释在config.py配好LLM_MODEL与API_KEY修改脚本中的LANG如English与对应的TransPrompt翻译指令运行python multi_language.py由于 GPT 偶有错误需要多次运行以提高覆盖率也可用CACHE_ONLYTrue python multi_language.py仅使用缓存映射翻译结果保存在multi-language/语言/目录翻译映射缓存于docs/translation_*.json仓库中已沉淀了 docs/translate_english.json、docs/translate_japanese.json 等映射文件。multi_language.py内部还实现了文件级 LRU 缓存装饰器lru_file_cache见 multi_language.py避免重复请求相同文本。这也解释了 README 中上面看到过 5 种语言的 README这句话——多语言 README 正是该脚本的产物。九、版本演进与分支策略文档给出了 1.0 → 3.70(todo) 的完整版本线关键节点2.0引入模块化插件2.2插件支持热重载2.4PDF 翻译、布局上下互换、多线程插件优化3.0支持 ChatGLM 等小参数 LLM3.1多 GPT 模型并发问询、多 apikey 负载均衡、api2d 支持3.4arXiv 文档翻译与 LaTeX 文档校对3.44官方支持 Azure3.49百度千帆与文心一言3.50虚空终端以自然语言调用全部插件功能、插件分类3.57GLM3/星火 v3/文心 v4 支持与本地模型并发 bug 修复3.60引入 AutoGen 作为新一代插件基础3.70todoAutoGen 主题展示优化与配套插件开发。需要说明的是仓库根目录的版本标记文件 version 当前为 4.00附新特性说明优化文件对话使用逻辑、新增速读论文即该意大利语文档所记录的版本线略早于仓库当前版本阅读版本历史时以实际 docs/reference/changelog.md 为准。分支策略方面文档明确两个分支master稳定版与frontier开发测试版。十、已知问题与注意事项文档在结尾列出的已知问题值得在部署前了解部分浏览器翻译插件会干扰本软件前端运行访问页面时建议关闭Gradio 官方 app 存在兼容性 bug建议通过requirements.txt安装 Gradio 而非另行 pip 安装界面主题通过 config.py 的THEME修改文档点名的Chuanhu-Small-and-Beautiful主题与当前 config.py 的AVAIL_THEMES一致。小结以 docs/README.Italian.md 为骨架可以完整勾勒出 gpt_academic 的使用主线三种安装路径pip install -r requirements.txtpython main.py直跑、docker-compose up多方案镜像、一键脚本/云部署覆盖从个人到服务器的部署场景三层配置优先级环境变量 config_private.pyconfig.py由 shared_utils/config_loader.py 严格实现是理解其 Docker 环境变量写法的关键快捷键与插件两级扩展机制core_functional.py 字典配置 crazy_functions/插件类则保证了按钮即提示词、插件即能力的模块化设计落地。想进一步深入可依次阅读 docs/get_started/quickstart.md、docs/customization/plugin_development.md 与 docs/self_analysis.md。【免费下载链接】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），仅供参考