ctfbridge 0.2.1

A Python library for interacting with multiple CTF platforms.

CTFBridge

CTFBridge is a Python library for interacting with multiple CTF platforms through a unified interface.

[!WARNING] Under active development – expect breaking changes.

Overview

CTFBridge provides a simple, unified API to interact with different Capture the Flag (CTF) competition platforms like CTFd and more.

It hides platform-specific quirks and gives you consistent access to challenges, submissions, and authentication across platforms.

Features

• 🌟 Unified API across different CTF platforms
• 📄 Fetch challenges, attachments, and challenge metadata
• 🔑 Handle logins, sessions, and authentication cleanly
• ⚡ Automatic rate-limiting and retry handling
• 🧩 Easy to extend with new platform clients
• 🧪 Demo client for quick testing without external servers

Installation

pip install ctfbridge

Basic Usage

import asyncio
from ctfbridge import create_client

async def main():
    # Connect and authenticate
    client = await create_client("https://demo.ctfd.io")
    await client.auth.login(username="admin", password="password")

    # Get challenges
    challenges = await client.challenges.get_all()
    for chal in challenges:
        print(f"[{chal.category}] {chal.name} ({chal.value} points)")

    # Submit flags
    await client.challenges.submit(challenge_id=1, flag="CTF{flag}")

    # View the scoreboard
    scoreboard = await client.scoreboard.get_top(5)
    for entry in scoreboard:
        print(f"[+] {entry.rank}. {entry.name} - {entry.score} points")

if __name__ == "__main__":
    asyncio.run(main())

Supported Platforms

Platform	Status
CTFd	✅ Supported
rCTF	✅ Supported
Berg	✅ Supported
EPT	✅ Supported
HTB	✅ Supported
More platforms	🚧 In development

Documentation

Full documentation: ctfbridge.readthedocs.io

Projects Using CTFBridge

These projects use ctfbridge:

• ctf-dl — Automates downloading all challenges from a CTF.
• pwnv — Manages CTFs and challenges.

License

MIT License © 2025 bjornmorten