Paste-RS

A minimalist self-hosted pastebin service with Reed-Solomon (RS) error correction.
Built with FastAPI and served via Granian.

Getting Started

Prerequisites

• Python: 3.13.0 (managed via pyenv)
• Package Manager: UV (for Python dependencies)

Installation

1. Clone the repository

   git clone https://github.com/mango-habanero/paste-rs.git
   cd paste-rs

2. Install dependencies

   uv sync --extra dev

Environment Setup

1. Create environment configuration

   cp .env.example .env

2. Configure environment variables (.env):

   # server configuration
   HOST=127.0.0.1
   PORT=8000
   WORKERS=1
   
   # application configuration
   ENVIRONMENT=development

Quick Start

1. Start the development server

   granian --interface asgi src.app:app

2. Verify the installation

   curl http://localhost:8000/health

3. Access the API documentation Open http://localhost:8000/docs in your browser.

Documentation

• TDD.md – Technical Design Document