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 1, 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:
Newer release available (0.4.1)

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 1, 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.0.tar.gz (345.9 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.0-py3-none-any.whl (360.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: kotobase-0.4.0.tar.gz
  • Upload date:
  • Size: 345.9 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.0.tar.gz
Algorithm Hash digest
SHA256 c6baa86630721c33fb0cad7d54e85cc1d01e316c52f2070feb8a6b7869ae6ab5
MD5 b281de018a0aebe74613e12aca794e95
BLAKE2b-256 4d9d76440cbbcd27fe62c9921a26365d7cddb99758dd2e095e6538e1319e5eb3

See more details on using hashes here.

Provenance

The following attestation bundles were made for kotobase-0.4.0.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.0-py3-none-any.whl.

File metadata

  • Download URL: kotobase-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 360.0 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9ccf19c03c4c3356e5fb96031e3309b64d0150cafa0a25fcab4832e7ce5334c2
MD5 a42c6a76998cf19f6f1b70e5be1431d1
BLAKE2b-256 35e7960f3f2a994c3783ca9d3b38ac74eabb8fd78c4b1b95892910114f4d75be

See more details on using hashes here.

Provenance

The following attestation bundles were made for kotobase-0.4.0-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