Open Source • AI-Powered

Your Year on
the Fediverse

Generate stunning year-in-review reports for your Mastodon activity. Beautiful visualizations, AI-powered insights, completely self-contained HTML files.

Everything You Need

A complete toolkit for reflecting on your Fediverse year

🤖

AI-Powered Insights

Uses local LLMs via Ollama to analyze your posts and generate personalized narratives, emotional vibes, and fun facts—all while keeping your data private.

📊

Rich Visualizations

Activity calendars, posting heatmaps, hourly patterns, hashtag clouds, and engagement metrics—all beautifully rendered in a modern dark theme.

📦

Self-Contained Output

Every report is a single HTML file with embedded CSS and base64 images. Share it anywhere, view it offline—no external dependencies.

🔒

Privacy First

All processing happens locally on your machine. Your posts never leave your computer, and AI analysis uses your own Ollama instance.

🎨

Year-Themed Colors

Each year gets its own color palette. From violet to emerald to amber—your reports are visually distinct and memorable.

Simple Shell Script

No complex setup. Just a bash script with jq and curl. Works on macOS and Linux. Optional toot CLI for fetching new data.

How It Works

Three simple steps to your personalized year in review

1

Fetch Your Data

Use the toot CLI or export your posts. Fedi-Wrap reads standard JSON format from Mastodon-compatible platforms.

2

Run the Script

Execute wrapped.sh with your year and handle. The script crunches numbers and optionally calls your local AI for insights.

3

Share Your Wrap

Get a beautiful, self-contained HTML file. Share it on social media, your blog, or keep it as a personal memory.

Quick Start

Get your wrapped in minutes

terminal
# Clone the repository
git clone https://github.com/anantshri/fedi-wrap.git
cd fedi-wrap

# Generate your 2025 wrapped
./wrapped.sh 2025 yourname@instance.social

# With custom AI model
OLLAMA_MODEL=phi4:latest ./wrapped.sh 2025 yourname@instance.social