selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

hanabira.org logo

Self-host hanabira.org

v0.3.8

Japanese & Korean learning portal with immersion tools

AlphaOpen CoreMIT
Updatedlast year
LanguageTypescript
Setup difficultyModerate
MobileResponsive
ThemeDark mode
Stars
428
Port
80 (nginx reverse proxy (main web UI))
Requires
MongoDB
Docker
coil/hanabira.org:frontend-next
Install with Docker Compose
Hanabira landing pageText parser tokenization viewYouTube immersion player with interactive subtitlesGrammar relation graphGrammar explanations pageWord relations graphSelf-hosted Hanabira running in VirtualBox VM

What is hanabira.org?

Hanabira.org is a free, open-source language learning platform focused on Japanese (JLPT N5–N1) and Korean (TOPIK). It combines immersion tools — YouTube and Netflix subtitle parsing, manga OCR, EPUB reader — with structured study: a WaniKani-style kanji path (Hanamichi), SRS flashcards, grammar library, quizzes, and interactive relation graphs. All learned words feed a single knowledge profile so furigana fades on known kanji and every tool shows what percentage of a video or text you already know. The self-hosted edition runs via Docker Compose (nginx on port 8888, Next.js frontend, Express/Flask backends, dictionary service) and uses MongoDB for data. Core features are free forever; a $1/month Patreon Supporter plan unlocks unlimited AI-powered immersion, OCR, and LLM translations. The project is in public alpha (v0.9.0 on the live site, v0.3.x prereleases on GitHub) and the maintainer notes containers are large, unoptimized, and run as root.

Should you self-host hanabira.org?

hanabira.org scores 44/100 on selfhost.directory (how scoring works) and ranks #21 of 30 in Education. It has 428 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is flashcards-open-source-app (45/100, 103 stars). It scores higher overall, so compare the two before you pick. See hanabira.org vs flashcards-open-source-app side by side.

Features

  • Chrome ExtensionDesktop only; installs via GitHub (Developer Mode).
  • Classroom ToolsFree 30-day trial, then $12/seat/year (min 3 seats).
  • EPUB / Light Novel ReaderRequires Supporter plan.
  • Grammar Explanations
  • Grammar Graph / Sentence Analyzer
  • JLPT/TOPIK Drills & Quizzes
  • Kanji Path (Hanamichi)N2 and N1 not yet included.
  • Manga OCR & ReaderFull OCR requires Supporter plan; online reader free with limits.
  • SRS Flashcards
  • Text Parser
  • Unified Knowledge Graph
  • Vocabulary & Sentence Mining
  • Word Relations Graph
  • YouTube ImmersionFull feature requires Supporter plan ($1/month); two demo videos free.

hanabira.org README

How to install hanabira.org

Install hanabira.org with Docker Compose

Docker, Docker Compose; clean Ubuntu VM recommended

git clone https://github.com/tristcoil/hanabira.org.git cd hanabira.org docker-compose up

Images are several GB each, unoptimized, run as root. Access at http://localhost:8888/. Audio files not included when building locally.

hanabira.org releases & version history

FAQ

Can I self-host it?

Yes. Spin up the full platform locally with Docker in minutes. Great for privacy or offline use. See the GitHub repo for setup instructions.

Is it open source?

Most of Hanabira is open source on GitHub. Some AI-powered features stay closed and are available to Supporters only.

Which languages are supported?

Japanese and Korean are fully supported — immersion player, text parser, flashcards, grammar guides, and sentence analysis. More languages may follow.

Are the grammar lessons really free?

Yes. Full grammar lessons with audio from JLPT N5 to N1 are free to use and download, even for commercial purposes, under Creative Commons ShareAlike.

Is this a complete Japanese & Korean learning platform?

It covers immersion tools, JLPT/TOPIK prep, grammar, vocabulary, kanji, and sentence mining — everything needed from N5 to N1. Works best alongside native content like YouTube and manga.

Why not just use Anki for flashcards?

Anki excels at deep customization; Hanabira's cards are built for fast daily reviews with audio included and JLPT structure. Use both: import Anki decks so Hanabira knows what you have, export manga cards back via AnkiConnect.

Is the development sustainable long term?

Yes. Patron subscriptions cover hosting and AI API costs, keeping the platform alive and ad-free.

Will you ever run ads?

Never. Hanabira is funded entirely by Patreon supporters; ads and language learning are incompatible.

Is the website free?

Core study tools (Hanamichi, flashcards, grammar browser, quizzes, readers, sentence analysis) are free forever with no ads or time limits. The Supporter plan ($1/month via Patreon, 7-day trial) unlocks AI features: full YouTube immersion, text parser, OCR, LLM translations, higher daily limits.

Does it work on my phone?

Yes. The site is mobile-first and installs as a home-screen app; flashcards, readers, quizzes, and grammar library all work on mobile. The Chrome extension is desktop-only.

I already use Anki, WaniKani or Bunpro. Do I switch?

No. Use Hanabira for the part those tools don't do — turning what you watch and read into study material. Import Anki decks so Hanabira knows what you have; manga cards export back via AnkiConnect.

How long until I can watch without subtitles?

There's no fixed timeline — it depends on hours, not months. Hanabira shows the percentage of known words in every video, book, and article so you can track progress.

Do I need to know some Japanese already?

No. The free step-by-step path starts at hiragana and walks you to your first real sentences. Immersion tools become useful once you have a few hundred words.

More in Education

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…