README

Jan - 开源 ChatGPT 替代方案




  English ·
  中文 ·
  日本語



  
  
  
  
  
  



  快速开始
  - 社区
  - 更新日志
  - 问题反馈


Jan 致力于通过易于使用的产品，将开源 AI 的精华呈现给大众。下载并运行大语言模型 (LLMs)，享有完全的控制权和隐私保护。

 安装 (Installation)


  
    
      
      
        
          
        
      
      
      
      
      
        
          
        
      
    
  


最简单的入门方式是根据您的操作系统下载以下版本之一：


  
    平台
    下载链接
  
  
    Windows
    jan.exe
  
  
    macOS
    jan.dmg
  
  
    Linux (deb)
    jan.deb
  
  
    Linux (AppImage)
    jan.AppImage
  
  
    Linux (Arm64)
    操作指南
  



您可以从 jan.ai 或 GitHub Releases 下载。

 核心功能 (Features)

- 本地 AI 模型：从 HuggingFace 下载并运行大语言模型（Llama, Gemma, Qwen, GPT-oss 等）
- 云端集成：通过 OpenAI 连接 GPT 模型，通过 Anthropic 连接 Claude 模型，以及 Mistral, Groq 等
- 自定义助手：为您的任务创建专门的 AI 助手
- 兼容 OpenAI 的 API：在 localhost:1337 运行本地服务器，供其他应用程序调用
- 模型上下文协议 (MCP)：集成 MCP 以实现 Agent 自动化能力
- 隐私优先：当您需要时，所有内容均在本地运行

 源码构建 (Build from Source)

适合喜欢探索过程的用户：

 前置要求 (Prerequisites)

- Node.js ≥ 20.0.0
- Yarn ≥ 4.5.3
- Make ≥ 3.81
- Rust (用于 Tauri 构建)
- (仅限 macOS Apple Silicon) MetalToolchain 命令：xcodebuild -downloadComponent MetalToolchain

 使用 Make 运行

bash
git clone https://github.com/janhq/jan
cd jan
make dev


这将处理所有步骤：安装依赖、构建核心组件并启动应用程序。

可用的 make 命令：
- make dev - 完整的开发环境设置与启动
- make build - 生产版本构建
- make test - 运行测试和 lint 检查
- make clean - 清除所有生成文件并重新开始

 手动构建命令

bash
yarn install
yarn build:tauri:plugin:api
yarn build:core
yarn build:extensions
yarn dev


 系统要求 (System Requirements)

获得良好体验的最低配置：

- macOS: 13.6+ (3B 模型需 8GB RAM，7B 需 16GB，13B 需 32GB)
- Windows: 10+，支持 NVIDIA/AMD/Intel Arc GPU 加速
- Linux: 大多数发行版均可，支持 GPU 加速

有关详细的兼容性说明，请查看我们的安装指南。

 故障排除 (Troubleshooting)

如果运行出现问题：

1. 查看我们的故障排除文档
2. 复制您的错误日志和系统规格信息
3. 在我们的 Discord 🆘|jan-help 频道寻求帮助：Discord


 贡献 (Contributing)

欢迎参与贡献！请参阅 CONTRIBUTING.md 以获取完整信息。

 相关链接 (Links)

- 文档 - 建议阅读的操作手册
- API 参考 - 供开发者参考
- 更新日志 - 了解修复和变更内容
- Discord - 社区所在地

 联系我们 (Contact)

- Bug 反馈: GitHub Issues
- 商务合作: [email protected]
- 人才招聘: [email protected]
- 综合讨论: Discord

 许可证 (License)

Apache 2.0 - 因为分享即是关爱。

 致谢 (Acknowledgements)

站在巨人的肩膀上构建：

- Llama.cpp
- Tauri
- Scalar

Top issues

Discussions

Latest release

Jan v0.8.8: security fixes, llama.cpp 0.7.0, and Trusted Hosts for the local API

A security update to v0.8.7. We recommend updating. Your data and settings carry over; a few behaviours change, listed under What you might notice.

 Security

- Links in chat open in your browser. Links in model replies, tool results, model cards and release notes now always open in your system browser, never inside Jan's window. Links that aren't web or email links are shown as plain text.
- The local API server checks where browser requests come from. A web page can only call it if its origin is trusted: the s