Welcome – An Otter Wiki | WarmIndex

An Otter Wiki is a minimalistic, self-hosted wiki powered by Python, Markdown, and Git for collaborative content management, ideal for developers, teams, and individuals seeking a simple knowledge base.

🚀 Overview

OtterWiki is a lightweight wiki software that emphasizes simplicity and ease of use, storing all content in a Git repository for seamless version control and collaboration.

It solves the problem of overly complex wiki platforms by providing a minimalistic interface with essential features like Markdown editing, user authentication, and full page histories, without unnecessary bloat.

Built for developers documenting projects, teams managing internal knowledge, and indie makers creating personal wikis. The creator built it to offer a customizable, self-hosted alternative using familiar tools like Python and Git.

✨ Key Features

Minimalistic interface with dark-mode support, customizable sidebar (menu and page index)
Rich Markdown editor with syntax highlighting, support for tables, footnotes, fancy blocks, alerts, formulas, and Mermaid diagrams
Git-powered version tracking: full changelog, diff views, revert changes
User authentication with self-registration, password recovery, and admin settings
File uploads, attachments, direct image pasting
Experimental: Embeddings (DataTable, ImageFrame, etc.), Git HTTP server for clone/pull/push, plugin support

🛠 Tech Stack

Frontend: halfmoon (CSS framework), CodeMirror (editor), Font Awesome (icons)
Backend: Python, Flask
Database: Git repository (no traditional DB)
Auth: Built-in user authentication
Hosting: Docker Compose, Kubernetes (Helm), self-hosted

👥 Who Is This For?

This project is useful for:

Developers who want to ___quickly set up project documentation with Git integration
Teams looking for ___a lightweight, self-hosted internal wiki
Indie makers building ___personal knowledge bases or notes

📸 Screenshots / Demo

Live demo: https://demo.otterwiki.com
GitHub: https://github.com/redimp/otterwiki

🔥 Project Status

🟢 Actively building

Last updated: 2026-03-24

❓ FAQ

Is this project free?

Yes / Open Source (Self-hosted with no licensing fees; MIT License.)

Is the source code available?

Yes — https://github.com/redimp/otterwiki

Can I contribute?

Yes, fork the repo, submit pull requests, or open issues on GitHub. See the development guide at https://otterwiki.com/development for setup instructions.