czechfabric-sdk 0.2.0

Python SDK for Czech Intelligence Fabric (CzechFabric MCP)

🇨🇿 CzechFabric SDK

The official Python SDK for accessing the Czech Intelligence Fabric (MCP) - a unified API for public services like public transport, geolocation, and stop metadata across the Czech Republic.

---

🚀 Features

• Plan public transport trips using OTP
• Get real-time departures from any stop or coordinates
• Geocode and reverse-geocode locations
• Search nearby transport stops
• Fetch detailed stop metadata
• Built-in retry and caching support

---

📦 Installation

pip install czechfabric-sdk

---

🧪 Quick Start

from czechfabric_sdk.client import CzechFabricClient

client = CzechFabricClient(
    api_key="your-api-key",
    base_url="https://mcp.czechfabric.cz"
)

# Plan a trip
trip = await client.plan_trip("Florenc", "Karlovo náměstí", departure_time="in 15 minutes")
print(trip)

---

📚 Usage Examples

All usage examples are available in examples.md:

• Trip planning
• Get departures
• Geocode
• Reverse geocode
• Nearby stops
• Stop metadata
• List stops

---

🧪 Running Tests

This SDK includes pytest-based tests for all endpoints.

pip install -r requirements-dev.txt
pytest tests/

---

📜 License

MIT © 2025 Aliyu Abdulbasit Ayinde

---

🌐 Project Links

• Czech Intelligence Fabric: https://mcp.czechfabric.cz
• Issues / Feedback: GitHub Issues