README.md

ResQ PyPI Packages

Python packages for the ResQ disaster response platform, published to PyPI under the resq-software organization.

Packages

Package	Description	Version
resq-mcp	FastMCP server -- connects AI agents to drone fleet, simulations, and disaster intelligence
resq-dsa	Zero-dependency data structures & algorithms for search, rescue, and geospatial ops

Architecture

graph TB
    subgraph "resq-software/pypi"
        subgraph "packages/resq-mcp"
            MCP[resq-mcp<br/><i>FastMCP Server</i>]
            DTSOP[DTSOP<br/>Digital Twin Simulations]
            HCE[HCE<br/>Hybrid Coordination]
            PDIE[PDIE<br/>Predictive Intelligence]
            DRONE[Drone Fleet<br/>Telemetry & Control]
            MCP --> DTSOP
            MCP --> HCE
            MCP --> PDIE
            MCP --> DRONE
        end
        subgraph "packages/resq-dsa"
            DSA[resq-dsa<br/><i>Zero-Dep DSA</i>]
            BF[BloomFilter]
            CMS[CountMinSketch]
            GR[Graph + A*]
            HP[BoundedHeap]
            TR[Trie]
            DSA --> BF
            DSA --> CMS
            DSA --> GR
            DSA --> HP
            DSA --> TR
        end
    end

    AI[AI Clients<br/>Claude / VS Code / Cursor] -->|MCP protocol| MCP
    APP[Python Applications] -->|pip install| DSA

Loading

Quick Start

# Install a package
pip install resq-mcp   # MCP server for AI agents
pip install resq-dsa   # Data structures (zero dependencies)

Development

# Clone and setup
git clone https://github.com/resq-software/pypi.git && cd pypi
./bootstrap.sh

# Work on a package
cd packages/resq-mcp && uv sync && uv run pytest
cd packages/resq-dsa && uv sync && uv run pytest

Release Flow

graph LR
    PUSH[Push to main] --> SR[Semantic Release]
    SR -->|feat: / fix:| BUMP[Version Bump + Changelog]
    BUMP --> BUILD[Build sdist + wheel]
    BUILD --> ATTEST[Sigstore Attestation]
    ATTEST --> PYPI[Publish to PyPI]
    PYPI --> DOCKER[Docker Image<br/><i>resq-mcp only</i>]

Loading

Both packages use python-semantic-release with Trusted Publisher OIDC. Conventional commits on main automatically version, changelog, and publish.

License

Apache-2.0 -- Copyright 2025 ResQ Software