Skip to content

Magetools

Magetools Logo

  • Active Discovery

    Discover tools from the filesystem at runtime. No hardcoding, no redeploys.

    Learn more

  • Strict Security

    Cryptographic manifests and sanitized imports ensure your agents only run authorized code.

    View security

  • Hierarchical Meta-Sync

    Automatically generate technical summaries for collections to optimize agentic search.

    Explore metadata

  • Provider Agnostic

    Built-in support for Google GenAI and ChromaDB with graceful fallbacks.

    Getting started

📽️ How it works

Magetools follows the Hierarchical Active Discovery pattern. Instead of giving an agent 5,000 tools at once, you give it the ability to browse and explore.

graph TD
    A[Agent] -->|Search| B(Grimorium Index)
    B -->|Match| C[Collection Summary]
    C -->|Query| D(Spell Search)
    D -->|Exec| E[Target Tool]

    style A fill:#f9f,stroke:#333,stroke-width:2px
    style E fill:#bfb,stroke:#333,stroke-width:2px

🚀 Quick Start in 30 Seconds

# Install with all features
uv add magetools[full]

# Initialize a new tool collection
uv run -m magetools init ./my_tools

# Build the search index and summaries
uv run -m magetools scan
[Getting Started](user_guide/getting_started.md){ .md-button .md-button--primary } [View GitHub](https://github.com/IAmNo1Special/magetools){ .md-button }