# bryceyuuu/run

> run is a handbook for Chinese passport holders who are looking at routes for moving abroad, with most of its detail on Europe. It sorts residence and work routes by income source, such as digital nomad, skilled work, study-to-work, startup, retirement and investment routes. The handbook is written in Chinese and built from Markdown and JSON data using Python. It is for information only and is not legal, tax or investment advice.

Source: https://github.com/bryceyuuu/run
Indexed: commit 952c3e3 on 2026-11-08 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Language: Python
- Stars: 4,931 at index time
- License: CC-BY-SA-4.0
- Code health: 6.3/10, Fair
- Last commit: 2026-11-03
- Contributors: 1

## Install

From the README: https://github.com/bryceyuuu/run

Clone the run repository.
    git clone https://github.com/bryceyuuu/run.git

Move into the run folder.
    cd run

Run the documentation build from the repository root.
    python3 scripts/build_docs.py

## How it works

Country and route content is edited under src/, and the Chinese front page README.md and its English counterpart README.en.md present it to readers. The single Python file, scripts/build_docs.py, builds the documentation from the guide and programme data: it reads two JSON data files and a notes folder from the repository root, locating them from its own position. data/changes.json is a central data file that holds the dated policy changes shown in the handbook's timeline. programmes.csv holds the route data in structured form for spreadsheet use. DISCLAIMER.md sets out the limits on what the handbook says, and CONTRIBUTING.md explains how changes are proposed.

- CONTRIBUTING.md: central file
- DISCLAIMER.md: central file
- README.en.md: central file
- README.md: central file
- data/changes.json: central file
Modules: scripts. 140 files, 506 lines, 43 symbols.

## Code health

- Score: 6.3/10 (Fair)
- Rank: #204 of 4,000+ indexed repos
- Hotspots: none
- Lowest file: scripts/build_docs.py
- Dead code: none found

## Maintenance

- Last commit 2026-11-03, first commit 2026-10-29, 5 commits
- 1 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/bryceyuuu/run/security

## More

- Page: https://repowise.dev/repo/bryceyuuu/run
- Ask this codebase: https://repowise.dev/repo/bryceyuuu/run/chat
- Docs: https://repowise.dev/repo/bryceyuuu/run/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/bryceyuuu/run
