PyFed

A robust, type-safe ActivityPub federation library for Python.

Features

• Complete ActivityPub protocol implementation
• Type-safe models using Pydantic
• Flexible storage backends (SQL, Redis)
• Comprehensive security features
• Framework-agnostic design
• Async-first architecture

Installation

pip install pyfed

Quick Start

from pyfed.federation import FederationProtocol
from pyfed.models import APActivity, APActor

# Initialize federation handler
federation = FederationProtocol()

# Handle incoming activities
@federation.on_activity("Create")
async def handle_create(activity: APActivity):
    await federation.store_object(activity.object)

Documentation

• Getting Started
• Configuration Guide
• Architecture Overview
• Security Guide
• API Reference
• Testing Guide
• Running an Example

Requirements

• Python 3.9+
• PostgreSQL (recommended) or SQLite
• Redis (optional, for caching)