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.

---

📬 Contact & Links

• Website: https://otterwiki.com
• GitHub: https://github.com/redimp/otterwiki
• Twitter/X:
• Email:

---

Built with ❤️ and kept warm on WarmIndex.