A dead simple personal website engine for developers focused on simplicity

Koji, a self-hostable personal website engine for developers, has been released. It uses FastAPI, Markdown on disk, and a minimalist layout with no database, offering features like HTMX-based live search, SEO support, and AI-friendly llms.txt exports. The project is open-source under MIT license.

Koji is a self-hostable dead simple personal website for developers. No database, markdown on disk, and a fast, text-first minimalist layout. FastAPI — server-rendered HTML, minimal JavaScript Markdown + YAML — pages and posts in content/ HTMX — live blog search progressive enhancement SEO — meta tags, Open Graph, JSON-LD, sitemap, robots llms.txt — AI-friendly markdown exports spec https://llmstxt.org/ Docker — single-container deploy python -m venv .venv && source .venv/bin/activate pip install -r requirements.txt uvicorn app.main:app --reload Open http://localhost:8000 http://localhost:8000 . In development, saving files under content/ reloads markdown and site.yaml on the next request — refresh the browser. Set KOJI ENV=production in production to cache content in memory. docker compose up --build or Docker pytest after pip install -r requirements-dev.txt See Koji in production: muhammadhaseeb.me https://muhammadhaseeb.me Full guides for using and extending Koji: | Guide | Description | |---|---| Documentation index | Getting started /iam-mhaseeb/Koji/blob/main/docs/getting-started.md Configuration /iam-mhaseeb/Koji/blob/main/docs/configuration.md site.yaml option Content guide /iam-mhaseeb/Koji/blob/main/docs/content.md Theming /iam-mhaseeb/Koji/blob/main/docs/theming.md Deployment /iam-mhaseeb/Koji/blob/main/docs/deployment.md SEO /iam-mhaseeb/Koji/blob/main/docs/seo.md llms.txt /iam-mhaseeb/Koji/blob/main/docs/llms-txt.md Extending Koji /iam-mhaseeb/Koji/blob/main/docs/extending.md Architecture /iam-mhaseeb/Koji/blob/main/docs/architecture.md Edit content/site.yaml : title: "Your Name's blog" author: Your Name email: you@example.com url: https://yourdomain.com Add a post at content/posts/hello.md : --- title: Hello slug: hello date: 2026-06-02 description: My first post. --- Hello, world. MIT — see LICENSE /iam-mhaseeb/Koji/blob/main/LICENSE .