Skip to content

What is Corgi?

The Fediverse is vast. With thousands of instances and millions of users, discovering relevant content can feel like searching for a needle in an ever-growing haystack. You might miss brilliant discussions in your areas of interest, fail to connect with like-minded people, or spend precious time scrolling through content that doesn't resonate with you.

Corgi solves this discovery problem while respecting the core values of the Fediverse: privacy, user control, and decentralization.

The Discovery Challenge

Traditional social networks solve content discovery through invasive tracking and opaque algorithms. They build detailed profiles of your behavior, sell your data, and trap you in filter bubbles designed to maximize engagement at any cost.

The Fediverse rejected this model—but that creates a new challenge. Without centralized algorithms, how do you find the content and communities that matter to you?

Before Corgi

graph LR
    subgraph Current Experience
        USER[You] --> TIMELINE[Chronological Feed]
        TIMELINE --> MISS[Missed Content]
        TIMELINE --> NOISE[Information Overload]
        TIMELINE --> DISCONNECT[Isolated Communities]
    end

    style USER fill:#e3f2fd,stroke:#1976d2,color:#000
    style MISS fill:#ffebee,stroke:#f44336,color:#000
    style NOISE fill:#ffebee,stroke:#f44336,color:#000
    style DISCONNECT fill:#ffebee,stroke:#f44336,color:#000

After Corgi

graph LR
    subgraph Enhanced Experience
        USER[You] --> CORGI[Corgi Recommendations]
        CORGI --> DISCOVER[Relevant Content]
        CORGI --> CONNECT[Community Discovery]
        CORGI --> CONTROL[Your Preferences]
    end

    style USER fill:#e3f2fd,stroke:#1976d2,color:#000
    style CORGI fill:#f3e5f5,stroke:#7b1fa2,color:#000
    style DISCOVER fill:#e8f5e9,stroke:#4caf50,color:#000
    style CONNECT fill:#e8f5e9,stroke:#4caf50,color:#000
    style CONTROL fill:#e8f5e9,stroke:#4caf50,color:#000

How Corgi Works

Corgi is a privacy-first recommendation engine designed specifically for the Fediverse. It enhances your existing Mastodon experience without compromising your privacy or the decentralized nature of the network.

Core Principles

Privacy-First

  • No Tracking: Corgi never tracks you across the web
  • Local Processing: Sensitive data stays on your instance
  • User Aliases: Your identity is protected through one-way hashing
  • Data Minimization: We only collect what's necessary for recommendations

Community-Informed

  • Learn from Interactions: Recommendations improve based on what you boost, favorite, and engage with
  • Respect Social Graphs: Discover content from people your community trusts
  • Cross-Instance Discovery: Find relevant content from across the Fediverse
  • Ethical AI: Transparent algorithms with no dark patterns

Self-Hostable

  • Full Control: Run your own Corgi instance
  • Open Source: Inspect, modify, and contribute to the code
  • Instance Integration: Works seamlessly with existing Mastodon infrastructure
  • Resource Efficient: Designed to run on modest hardware

Key Features

Smart Timeline Enhancement

Instead of replacing your timeline, Corgi enhances it. See the content you care about while maintaining chronological context.

Content Similarity

Using advanced semantic understanding, Corgi finds posts similar to content you've engaged with—even if they use different words or hashtags.

Trend Detection

Discover what's gaining traction in your communities before it goes viral, helping you stay connected to emerging discussions.

Multi-Algorithm Approach

Corgi uses multiple recommendation algorithms that you can tune or disable based on your preferences:

  • Collaborative Filtering: Find content liked by similar users
  • Content-Based: Discover posts similar to your interests
  • Temporal Trends: Surface timely, relevant discussions
  • Social Proximity: Prioritize content from your extended network

Who Benefits from Corgi?

Fediverse Users

  • Find Your Tribe: Discover communities aligned with your interests
  • Reduce Noise: See more signal, less noise in your timeline
  • Stay Connected: Never miss important discussions
  • Maintain Privacy: Get recommendations without sacrificing privacy

Instance Administrators

  • Enhance User Experience: Offer better content discovery
  • Reduce Server Load: Efficient caching and processing
  • Maintain Control: Self-host and configure to your community's needs
  • Build Community: Help users find relevant content and connections

Developers

  • Open APIs: Build on top of Corgi's recommendation engine
  • Extensible Architecture: Add new algorithms and features
  • Well-Documented: Comprehensive guides and API references
  • Active Community: Join contributors improving the Fediverse

Getting Started

Ready to enhance your Fediverse experience? Our 5-minute integration guide will have you up and running quickly.

- :material-rocket-launch: **[5-Minute Integration](02_quick-integration.md)** --- Get Corgi running with Docker in under 5 minutes - :material-puzzle: **[ELK Integration Guide](../guides/01_elk-integration.md)** --- Seamlessly integrate Corgi with your ELK client - :material-cloud: **[First API Call](03_first-api-call.md)** --- Make your first recommendation request

Join the Movement

Corgi is more than software—it's a commitment to proving that we can have both intelligent content discovery and uncompromising privacy. By choosing Corgi, you're helping build a future where algorithms serve users, not advertisers.

Ready to get started? Continue to our 5-Minute Integration Guide →