1. Connect Your Vocabulary

Your journey begins by connecting your known vocabulary. We offer two ways to do this:

Option 1: WaniKani Integration

Connect your WaniKani account to use vocabulary you've already learned.

Getting Your API Key

  1. Log into WaniKani
  2. Go to Settings → API Tokens
  3. Click Generate a new token
  4. Copy the token and paste it into Asoi

Your API key is stored securely in your browser and never sent to our servers.

Option 2: Custom Vocabulary

Upload your vocabulary with word, reading, and meaning in 3 columns.

Required Format (word, reading, meaning)

犬,いぬ,dog
本,ほん,book
学生,がくせい,student
水,みず,water
日本,にほん,Japan
大きい,おおきい,big
小さい,ちいさい,small

Supports .csv, .txt, or .xlsx files. You can also download pre-made JLPT decks from the Downloads page.

2. Choose Your Games

Once your vocabulary is connected, you can choose from our collection of games designed to reinforce your Japanese knowledge:

Recall

Can you recall the reading for words from their English meanings?

Word Split

Can you split them right? Separate words joined together!

Kanji Twin

Spot the difference! Match kanji that look alike but aren’t the same.

Memory Match

Test your memory! Pair kanji with their meanings before time runs out.

Word Rush

Type readings before time runs out! Game speeds up as you build streaks.

Conjugate War

Master verbs by conjugating them into different forms!

All games use only your vocabulary. This ensures you're practicing words you already know, making the experience more effective.

3. Customize Your Experience

Each game offers customization options to match your learning style:

Game Settings

Adjust difficulty levels, input methods, and game length to fit your needs. Use helpful hints when you need assistance.

Vocabulary Filters

WaniKani users can filter by SRS stage to focus on specific sets of vocabulary at different learning stages.

Immediate Feedback

Each game provides immediate feedback on your performance:

  • See correct answers with kanji, readings, and meanings
  • Review your score and accuracy at the end of each game