Koimsurai/sora-to-ki

What is it?

Key features

• 01Five content sections (notes, moments, works, collection, log) that can each be turned off.
• 02MDX articles compiled and highlighted on the server, with extra blocks such as code tabs and Mermaid charts.
• 03Five-language support with per-article translations and automatic Simplified Chinese conversion.
• 04Admin area for writing, comment moderation, link-exchange checks, and newsletter subscribers.
• 05Built-in MCP server with 31 tools so an AI assistant can publish posts and edit settings via the admin API.
• 06Docker Compose deployment with automatic HTTPS through bundled Caddy and daily SQLite backups.

Use cases

• Running a personal blog or portfolio site that also tracks reading, viewing, and GitHub projects.
• Hosting a multilingual personal site for readers who use Chinese, English, Japanese or Korean.
• Self-hosting a personal website on a single server with Docker and your own domain.
• Letting an AI assistant draft and publish posts through the MCP server.

Quick start

1. 1

   Clone the repository

   git clone https://github.com/Koimsurai/sora-to-ki.git
2. 2

   Enter the project folder and copy the example env file

   cd sora-to-ki && cp .env.example .env
3. 3

   Start the services with Docker Compose

   docker compose up -d
4. 4

   Open the first-time setup link printed in the backend log

   docker compose logs backend-rs | grep setup

Things to know

• !Requires Docker and a machine with a domain pointing at it.
• !Sign-in needs you to create a GitHub or Google OAuth app yourself.
• !Licensed under AGPL-3.0, a copyleft license that requires sharing modified source when run as a network service.

In collections

Topics

FAQ

What is sora-to-ki?

A self-hostable personal website with notes, moments, works, a bookshelf-style collection, and a voyage log, built on React 19 and Rust (axum + SQLite). sora-to-ki is a one-person personal site with five content sections: notes (articles), moments (short posts), works (GitHub repos), a collection (books, film and TV, music), and a log of milestones. Each section is drawn as a different element of one night-sky theme, and a section can be turned off in the admin, which removes it from the home page.

Is sora-to-ki free to use? What license does it have?

sora-to-ki is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.

Is sora-to-ki still maintained?

Actively maintained. The last commit to sora-to-ki was on Nov 6, 2026.

What can I use sora-to-ki for?

Running a personal blog or portfolio site that also tracks reading, viewing, and GitHub projects. Hosting a multilingual personal site for readers who use Chinese, English, Japanese or Korean. Self-hosting a personal website on a single server with Docker and your own domain. Letting an AI assistant draft and publish posts through the MCP server.

How do I install sora-to-ki?

Clone the repository: git clone https://github.com/Koimsurai/sora-to-ki.git Enter the project folder and copy the example env file: cd sora-to-ki && cp .env.example .env Start the services with Docker Compose: docker compose up -d Open the first-time setup link printed in the backend log: docker compose logs backend-rs | grep setup

Where can I get sora-to-ki?

The source code and installation instructions are on GitHub: https://github.com/Koimsurai/sora-to-ki