Kotobase

PyPI Python License Docs Database Build

A Comprehensive Japanese Language Database

Kotobase is a python package that aggregates several openly licensed Japanese Language data sources into one SQLite database and exposes simple programmatic access to it

Quickstart

Install

pip install kotobase

Get The Database File

# Get The Latest Release From GitHub
kotobase db pull

# Download Sources & Build Locally
kotobase db build

Access Data

CLI

# Runs Comprehensive Lookup Across All Sources
kotobase lookup all 日本語

Python

from kotobase import Kotobase

kb = Kotobase()

result = kb("日本語")

Features

Comprehensive Lookups One lookup all Query Aggregates Data From All Souces
Organized Data Every Source Is Fully Extracted Into A Normalized SQLite Schema & Exposed As Typed, Serializable DTOs
Example Sentences Search Tatoeba Example Sentences + Their English Translation By Text
Wildcard Search Match Written / Reading Forms With * & % Wildcard Patterns
CLI A Typer + Rich CLI With Readable, Panelled Output & --json For Scripting
Self-Contained A Single SQLite (~400MB) File + Optional Audio Pack (~150MB) With No Server / Network Access Needed At Query Time
Easy Database Management Pull Pre-Built Databases From GitHub Releases Or Build It Locally + Manage The Cache From The CLI

Help

Documentation Full API + CLI Reference
Examples Curated Usage Examples
Changelog Changes Between Versions

Data Sources & Licenses

Every source is openly licensed

The compiled database is a derived work of the sources below, and each row keeps its source and license where appropariate

See the Third-Party Notices for the full attribution text

Source Provides License
JMdict Dictionary Entries → Written + Reading Forms / Senses, Glosses, Part-Of-Speech / Register / Field / Dialect Tags, Priorities CC BY-SA 4.0
JMNedict Proper Names → People / Places / Organisations + Their Types CC BY-SA 4.0
KanjiDic2 Kanji Profiles → Readings / Meanings / Stroke Counts / Grades / Frequencies / SKIP / Dictionary References CC BY-SA 4.0
KRADFILE / RADKFILE Kanji To Radical Decomposition For Radical Search CC BY-SA 4.0
JmdictFurigana Per-Form Furigana Segmentation CC BY-SA 4.0
KanjiVG Stroke-Order SVG Paths CC BY-SA 3.0
Tatoeba Example Sentences With Japanese To English Translations CC BY 2.0 FR
Tanos JLPT JLPT Vocabulary / Kanji / Grammar Study Lists CC BY 4.0
Kanji Alive Word Pronunciation Audio (Optional Download) CC BY 4.0

Contributing

  • All contributions are welcome

  • See CONTRIBUTING for local setup, commands, and PR conventions

Project links

Data verified by PyPI on Jul 3, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for svdC1 from gravatar.com svdC1

Credits

Author/Maintainer: svdc

GitHub Statistics

Data verified by PyPI on Jul 3, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Provides Extra

docs dev

Tags

Japanese Dictionary Language JMdict Kanji JLPT Tatoeba

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kotobase-0.4.1.tar.gz (346.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kotobase-0.4.1-py3-none-any.whl (360.1 kB view details)

Uploaded Python 3

File details

Details for the file kotobase-0.4.1.tar.gz.

File metadata

  • Download URL: kotobase-0.4.1.tar.gz
  • Upload date:
  • Size: 346.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for kotobase-0.4.1.tar.gz
Algorithm Hash digest
SHA256 569b2d66083effcbf57fefef12e44c116bbfc83a0dcde0404a006c6a9086be7c
MD5 71e9e61721d33c960600162c41c73e00
BLAKE2b-256 89db653fc98fb917b7f1b7349ce86c89e45f307f7b0f06d5dba773e53b483cba

See more details on using hashes here.

Provenance

The following attestation bundles were made for kotobase-0.4.1.tar.gz:

Publisher: release.yaml on svdC1/kotobase

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file kotobase-0.4.1-py3-none-any.whl.

File metadata

  • Download URL: kotobase-0.4.1-py3-none-any.whl
  • Upload date:
  • Size: 360.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for kotobase-0.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e76f7e45e74d50a2fe13902249ce9ad7ed6b8087da10a063740c2f5cf57c867a
MD5 39f3051491727eebd62d4d29ce487dd9
BLAKE2b-256 dbe5641f899ac998367122a48b71b2e5483c69648835c92e53f83396de9e63fc

See more details on using hashes here.

Provenance

The following attestation bundles were made for kotobase-0.4.1-py3-none-any.whl:

Publisher: release.yaml on svdC1/kotobase

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page