Snipo

A lightweight, self-hosted snippet manager for single users.
Secure your code snippets, organize them seamlessly, and access them from anywhere.

---

What is Snipo?

Snipo is a self-hosted snippet management ecosystem built for developers who want complete control over their data. It is designed specifically for a single user, avoiding the complexity of tenant isolation and user accounts in favor of simplicity and strong security.

Whether you're in the terminal, IDE, or browser, Snipo ensures your code fragments, commands, and notes are always at your fingertips.

Note

: Snipo is designed for a single user. One master password protects the entire instance. No user management overhead!

_{Captured from Snipo's demo mode with its built-in sample snippets.}

See the multi-file code preview

The demo's REST API Client includes api_client.py, config.py, and main.py. Run make demo locally and sign in with the password demo to explore it.

Quick Start

Getting started with Snipo via Docker is incredibly easy.

1. Clone the repository:

   git clone https://github.com/MohamedElashri/snipo.git
   cd snipo
   

2. Configure your environment: Create a .env file from the provided example and fill in the necessary placeholders (like your master password).

   cp .env.example .env
   chmod 600 .env
   

3. Start the instance:

   docker compose up -d
   

Snipo will now be running on http://localhost:8080.

Important: Before exposing Snipo to the internet, please read the Deployment Guide for production recommendations!

The Snipo Ecosystem

Snipo extends far beyond a web interface. Check out the dedicated clients:

Client	Description	Link
Snippy	Fast TUI (Terminal User Interface) client	View TUI
VS Code	Editor extension for seamless workflow	View Extension
Browser	Chrome & Firefox companion extension	View Browser Ext

Documentation

Dive deeper into configuring, securing, and developing Snipo:

• ⚙️ Deployment & Configuration
• 🛡️ Security Model & Controls
• 💡 Feature Guide
• 🖌️ CSS Customization
• 🛠️ Development & Contribution Guide
• 📜 OpenAPI Specification
• 📝 Changelog

⚖️ License

Snipo is open-source software licensed under the GNU Affero General Public License v3.0.