gpt-newspaper

环境要求

• Python 3.11 或更高版本
• 一个免费的 Tavily API key（在 app.tavily.com 申请）
• 模型提供商的 API key（OpenAI/Anthropic/Google/Groq/Mistral/xAI/DeepSeek 任选），或本地 Ollama
• 能访问 8000 端口的本地浏览器

安装与启动步骤

1. 1克隆项目仓库

   把 gpt-newspaper 源码拉到本地，命令执行完会生成 gpt-newspaper 目录。

   git clone https://github.com/rotemweiss57/gpt-newspaper.git

   复制

2. 2安装 Python 依赖

   进入项目目录后用 pip 按 requirements.txt 安装全部依赖，建议先激活虚拟环境。

   cd gpt-newspaper
   pip install -r requirements.txt

   复制

3. 3启动应用

   运行 app.py 启动 Web 服务，保持这个终端窗口不要关闭。

   python app.py

   复制

4. 4打开网页填密钥

   浏览器访问本地 8000 端口，在 Model & API keys 里填入 Tavily 与模型提供商的密钥。

5. 5生成专属报纸

   挑选几个感兴趣的主题，点击 Print my newspaper，约一分钟即可看到实时生成的报纸首页。

6. 6Docker 方式(可选)

   不想装 Python 环境时可用 Docker Compose 一键构建并启动，密钥写在 .env 或 Web UI 均可。

   docker compose up --build

   复制

7. 7uv 方式(可选)

   用 uv 管理依赖时，按模型提供商选择 extra 后运行 app.py，例如 anthropic。

   uv sync --extra anthropic
   uv run app.py

   复制

关键配置

如何确认成功

本地浏览器打开 http://localhost:8000 能看到页面；填入密钥选好主题后点击 Print my newspaper，约一分钟内出现带引用来源的报纸首页。

常见问题

注意事项

• 所有配置项都是可选环境变量，也可通过 .env 文件设置，样例见 .env.example。
• 密钥既可以在环境变量里配置，也可以在网页的 Model & API keys 区域填写。
• 可设置 LANGSMITH_TRACING=true 并配合 LANGSMITH_API_KEY，追踪每个智能体步骤。
• README 说明信息源会被当作不可信数据而非指令处理，每条事实性陈述都会带编号引用。