Contributor Landing

Welcome. This project is looking for small, useful public contributions from language learners, Korean/Japanese reviewers, mobile accessibility reviewers, FastAPI/API docs contributors, and test-minded developers.

You do not need local speech engines, private data, generated audio, or API keys to make a useful first PR.

Start with the public contributor page, the hosted web demo, the 한국어 guide, the 한국어 contributor call, the 日本語 guide, the 日本語 contributor call, the contributor share kit, the directory first PR fast lane, or the starter issue index if you want a lane-by-lane list of currently open tasks.

If you want to help make the project easier for non-contributors to try, see the installable demo release plan.

For the lowest-friction route, use the five-minute first PR guide. It links directly to browser-editable issues and includes a PR body template.

If you came from an external good-first-issue directory, start with the directory first PR fast lane. It compresses the demo, issue choice, /claim, and PR body steps into one page.

If you want to run tests without setting up your own machine, use the Codespaces first PR guide.

Korean-speaking contributors can use the 한국어 5분 첫 PR guide.

Japanese-speaking contributors can use the 日本語 5分 first PR guide.

Language reviewers can use the language review first PR kit for safe JSON/CSV/TypeScript review boundaries and issue-specific starter routes.

If you are not sure which issue fits your skills or time budget, use the first issue matcher.

For step-by-step issue-specific guidance, see the first PR recipes.

If you want to contribute without installing anything, start with the no-install first PR board. It links directly to GitHub web-editor tasks for docs, Korean/Japanese review, and beginner dialogue content.

Pick Your Lane

I can help with… Start here Good first outcome
Korean docs or learner notes Korean docs issues Clearer setup or learner explanation
Japanese naturalness review Language-review issues Beginner-safe wording and tone
Dialogue content review Content issues Reviewed source text, no generated assets
Mobile accessibility Accessibility issues Better labels, touch targets, or layout
FastAPI/OpenAPI examples Backend docs issues Clear examples or provider docs
Tests/tooling Tests issues Focused repo, API, or fixture checks

If you are not sure where to start, ask in the First PR help desk discussion, comment on the 20 contributor sprint kickoff issue with the lane you prefer, or open a contributor interest issue. Korean-speaking contributors can use the 한국어 contributor interest form, and Japanese-speaking contributors can use the 日本語 contributor interest form.

Fastest First PR Path

  1. Pick one issue from the table above.
  2. Comment /claim on the issue if you want to avoid duplicate work; the repo will add the claimed label for maintainer triage.
  3. Read the first PR walkthrough.
  4. Make one focused change.
  5. Open a PR that links the issue and names the check you ran.

For docs or language review, the fastest path is the five-minute first PR guide or the no-install first PR board: pick a row, use the direct edit link, and submit a focused browser-only PR.

For tests, backend docs, or mobile checks, use the Codespaces first PR guide if you do not want to install Python, Node, or Expo locally.

If you need a maintainer to suggest a first issue, use the contributor interest form.

Docs-only and language-review PRs are welcome when they improve real learner or contributor experience.

What Not To Commit

Please do not commit:

  • generated .wav, .zip, .npy, .sqlite, .db, .bin, or screenshot files
  • local speech engine folders
  • private notes, handoff files, or personal paths
  • secrets, tokens, API keys, or private datasets

The repository intentionally keeps generated voice assets and local engines out of Git.

Project Rule

The Daily Talk path avoids runtime LLM/API calls. Learner audio is transcribed locally, matched against reviewed dialogue-bank lines, and answered with local TTS assets. Contributions should preserve that local-first design.

Claude for OSS Note

This project is building toward the Claude for OSS community-builder route: 20+ unique external contributors with useful merged PRs in the last 12 months.

Only real external contributors count. Maintainer-authored PRs, bots, duplicate identities, and trivial metric-only PRs are excluded. See the PR review and counting policy.