Content
# Tool List
> Author: [程序员鱼皮](https://yuyuanweb.feishu.cn/wiki/Abldw5WkjidySxkKxU2cQdAtnah)
>
> This project is a teaching project that provides complete video tutorials + text tutorials + resume writing + interview question solutions + Q&A services to help you improve your project capabilities and add highlights to your resume!
>
> ⭐️ Join the project series learning: [Join Programming Navigation](https://www.codefather.cn/vip)
## I. Project Introduction
This is a set of project tutorials based on **AI programming practice**, using Next.js + GitHub App + OpenRouter to develop a "GitHub Repository AI Document Translation SaaS Platform" from scratch with AI programming, allowing you to experience the complete workflow of AI Vibe Coding and learn to create practical, deployable, and profitable products with AI!
📺 Project introduction video, quickly check out the finished product: https://bilibili.com/video/BV1mAAmzqEfP
Enter any GitHub repository address, and AI automatically translates documents into multiple languages and synchronizes translations incrementally when the base language content changes, generating PRs for repository administrators to merge without manual intervention.
### Why create this project?
Yu Pi open-sourced an AI programming tutorial repository [ai-guide](https://github.com/liyupi/ai-guide) containing over 100 Chinese tutorial documents. To make overseas users accessible, we hope to translate the repository into multiple languages, but manual translation is costly, and GitHub Actions require custom configurations...
Instead, **create a more universal tool**.
This is the starting point of the GitHub Global project: enter any GitHub repository address, AI automatically translates documents into multiple languages and synchronizes translations incrementally when the base language content changes, generating PRs for repository administrators to merge without manual intervention.
Zero configuration, one-click translation, let your GitHub project go global!
### 6 Core Capabilities
1) Log in with your GitHub account with one click, implementing secure login and authorization based on GitHub App.
2) Import GitHub repository, enter the address to automatically pull repository information.
3) Configure translation, visually select translation range and target language (supporting 20 mainstream languages).
4) Execute translation with one click, display progress in real-time, and automatically create PR after translation.
Repository administrators can choose whether to merge this translation, making it convenient and safe:
5) Automatically trigger incremental translation, which automatically translates changed documents after enabling.
6) Customize large models and API Keys, supporting mainstream models like GPT, Claude, Gemini, and DeepSeek.
## II. Project Advantages
This project has a novel topic, keeping up with the AI programming era, and is oriented towards **real SaaS product development**, differing from common CRUD projects. The project content is refined, **can be learned in less than a week**, and teaches you the complete workflow of AI programming, greatly increasing the competitiveness of your resume and job search!
Rich technology, covering the entire AI programming chain:
You can learn from this project:
- How to use AI for demand research and generate professional "Demand Specification Documents"?
- How to develop frontends and backends simultaneously with multiple AI models?
- How to connect with GitHub App and implement secure OAuth authorization and repository operations?
- How to access OpenRouter and unify connections to hundreds of AI large models?
- How to use GitHub API to obtain repository file trees, submit files, and create PRs?
- How to implement event-driven automated translation with GitHub Webhook?
- How to use intranet penetration tools to debug Webhook callbacks locally?
- How to deploy Next.js full-stack projects quickly with Vercel and go live?
- How to perform code review, version control, and issue fixing in the AI development process?
- How to identify competitive product differentiation opportunities and design truly competitive products?
### Yu Pi Series Project Advantages
Yu Pi's original projects focus on **practicality**, using **live streaming** to **build from scratch**, covering demand analysis, technical selection, project design, project initialization, demo writing, frontend and backend development, project optimization, deployment, and launch. Each link is explained clearly from theory to practice, with every detail covered!
Compared to online tutorials, Yu Pi's project series advantages include: from learning knowledge => practicing projects => reviewing notes => project Q&A => resume writing => interview question solutions, providing one-stop services.
Programming Navigation has **20+ sets of project tutorials!** Each project has different learning focuses, mostly full-stack projects with frontend and backend, and many AI application development projects.
See details at: [https://codefather.cn/course](https://www.codefather.cn/course) (on the right side of the page, there are tutorial recommendations and learning suggestions)
Past project introduction videos: [https://bilibili.com/video/BV1YvmbYbEgS](https://www.bilibili.com/video/BV1YvmbYbEgS/)
Yu Pi's projects have helped many students get high-paying offers from top companies:
## III. More Introduction
Function modules:
Architecture design:
## IV. Quick Start
> Refer to the detailed tutorial for [local running guide](./docs/local-running-guide.md)
### Prerequisites
- Node.js >= 20
- MySQL >= 8.0
- A [GitHub App](https://github.com/settings/apps/new) (for login and repository operations)
- An [OpenRouter API Key](https://openrouter.ai/keys) (for AI translation)
### 1. Clone and install dependencies
```bash
git clone https://github.com/liyupi/github-global.git
cd github-global
npm install
```
### 2. Configure environment variables
```bash
# Create environment variable files (keep content consistent in both files)
cp .env.example .env
cp .env.example .env.local
```
Edit `.env` and `.env.local`, fill in your configurations:
```bash
DATABASE_URL=mysql://root:your-password@localhost:3306/github_global
NEXTAUTH_URL=http://localhost:3123
AUTH_SECRET=random-string-at-least-32-characters
GITHUB_APP_ID=your-AppID
GITHUB_APP_CLIENT_ID=your-ClientID
GITHUB_APP_CLIENT_SECRET=your-ClientSecret
GITHUB_APP_PRIVATE_KEY_PATH=./private-key.pem
PLATFORM_OPENROUTER_API_KEY=sk-or-v1-your-key
```
Save the GitHub App private key file as `private-key.pem` in the project root directory.
### 3. Initialize database and start
```bash
# Create database (MySQL command line)
mysql -u root -p -e "CREATE DATABASE github_global CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
# Generate Prisma client + create tables
npx prisma generate
npx prisma db push
# Start development server
npm run dev
```
Access **http://localhost:3123** to use.
### Docker Deployment
```bash
docker-compose up -d
docker-compose exec app npx prisma db push
```
See more details in [local running guide](./docs/local-running-guide.md) and [manual configuration documentation](./docs/manual-configuration-documentation.md).
## Join Project Learning
Programming Navigation has **20+ sets of project tutorials!** Each project has different learning focuses, mostly full-stack projects with frontend and backend, and many AI application development projects.
Welcome to join [Programming Navigation](https://www.codefather.cn/vip). After joining, you can follow this project and over 20 past original project tutorials. You can also enjoy more original technical information, learning and job search guidance, and over 100 interview replay videos.
🧧 Help new project learning, we provide **limited-time Programming Navigation discount coupons**. Scan the QR code to get the coupon and join. If you're not satisfied within three days, you can get a full refund. Welcome to experience, limited spots available!
<img width="404" alt="image" src="https://github.com/user-attachments/assets/56411098-b60e-4267-8ba2-4ebc5d416afc" />
Less than 1 block per day, it's definitely worth the investment in yourself! After becoming a Programming Navigation member, you can unlock over 20 sets of project tutorials and materials, available on PC and APP:
