ctfbridge 0.3.0

A Python library for interacting with multiple CTF platforms.

CTFBridge

A unified Python interface for all major CTF platforms

Features • Install • Quickstart • Docs • License

---

✨ Features

• ✅ Unified API for multiple CTF platforms — no per-platform hacks
• 🧠 Auto-detect platform type from just a URL
• 🔐 Clean auth flow with support for credentials and API tokens
• 🧩 Challenge enrichment — authors, categories, services, attachments
• 🔄 Persistent sessions — save/load session state with ease
• 🤖 Async-first design — perfect for scripts, tools, and automation

📦 Installation

pip install ctfbridge

🚀 Quickstart

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

CTFBridge works out of the box with:

Platform	Auth	Challenges	Flags	Scoreboard
CTFd	✅	✅	✅	✅
rCTF	✅	✅	✅	✅
HTB	✅	✅	✅	✅
Berg	❌	✅	❌	❌
EPT	❌	✅	❌	❌
More...	🚧	🚧	🚧	🚧

📖 See docs for details.

📚 Documentation

All guides, API references, and platform notes are available at: ctfbridge.readthedocs.io

🤝 Contributing

Contributions are welcome! We appreciate any help, from bug reports and feature requests to code enhancements and documentation improvements.

Please read our Contributing Guidelines to get started.

🛠️ Projects Using CTFBridge

These open-source projects are already using CTFBridge:

• ctf-dl — 🗃️ Download all CTF challenges in bulk
• pwnv — 🧠 CLI to manage CTFs and challenges

📄 License

MIT License © 2025 bjornmorten