Skip to content
Takuhon

Takuhon

Your identity, made portable.
Get started View on GitHub View on npm

What is Takuhon?

Section titled “What is Takuhon?”

Takuhon lets you own your profile — bio, social links, career history, projects, and skills — as a single portable JSON document, and publish it as a mobile-first profile page plus a public API, including JSON-LD for AI agents and search engines.

The canonical data lives in one takuhon.json file on your own server. Storage backends — Cloudflare KV, a static file, and more — are pluggable through adapters, so your profile is never locked to a single platform.

Why “Takuhon”? (拓本)

Section titled “Why “Takuhon”? (拓本)”

The name Takuhon (拓本) comes from a 2000-year-old craft: pressing paper against a stone inscription to lift a portable rubbing of the original. The stone stays put; the paper carries its imprint anywhere.

  • The original is immutable — your career and story at a given moment, like a stone inscription.
  • The reproduction is portable — takuhon.json is the rubbing, carried into APIs, JSON-LD, and profile pages.
  • The reproduction outlasts the platform — when a platform shuts down, your takuhon.json survives.

Packages

Section titled “Packages”
  • @takuhon/core — JSON Schema, validation, locale resolution, JSON-LD generation, and storage interfaces
  • @takuhon/api — Hono-based HTTP handlers, the server-rendered profile page, and an RFC 7807 error envelope
  • @takuhon/ui — React mobile-first profile UI
  • @takuhon/cli — create-takuhon scaffolding plus validate, dev, build, sync, admin, and migrate
  • @takuhon/activity — developer-activity snapshots (GitHub languages + contributions, WakaTime time) and the activity badge
  • @takuhon/mcp — a read-only Model Context Protocol server so AI agents can read your profile

The @takuhon/cloudflare adapter builds on these for Workers + KV; a prebuilt static path (takuhon build), a read-only @takuhon/vercel adapter, and a WordPress plugin (Phase 1) ship today.

Install

Section titled “Install”
Terminal window
npm install -g takuhon

Then scaffold your profile and follow Get started for the full walkthrough.

Takuhon is open source under Apache-2.0. Source lives on GitHub; packages are published to npm. The takuhon.json schema is frozen at 1.0.0 as a stable contract — see Schema stability — and minor releases continue to add features without breaking it.