maestro-core

Core engine for Maestro AI agent. Multi-provider, privacy-first.

Features

4 LLM Providers: Anthropic (Claude), OpenAI (GPT), Google (Gemini), Ollama (local)
Trust Layer: Automatic anonymization of sensitive data (NIR, SIRET, IBAN, emails, names, API keys)
Provider Router: Auto-route to local/cloud based on data sensitivity
Conversation Engine: Turn loop with tool calling
Tool Framework: Base classes + 6 built-in tools (bash, file_read, file_write, file_edit, grep, glob)

Installation

pip install maestro-core

Usage

from maestro_core.engine import ConversationEngine
from maestro_core.provider_router import ProviderRouter, RoutingMode
from maestro_core.tools import ToolRegistry
from maestro_core.tools.bash import BashTool
from maestro_core.config import MaestroConfig
from maestro_core.trust.anonymizer import TrustMode

# Setup
config = MaestroConfig()
router = ProviderRouter(config, RoutingMode.AUTO, TrustMode.STANDARD)

tools = ToolRegistry()
tools.register(BashTool())

engine = ConversationEngine(router=router, tools=tools)

# Chat
result = await engine.run_turn("List Python files", model="claude-sonnet-4")
print(result.response_text)

Trust Layer

from maestro_core.trust.anonymizer import Anonymizer, TrustMode

anon = Anonymizer(TrustMode.STANDARD)
safe = anon.anonymize_text("NIR 267041305561777 SIRET 41021468800013")
# → "NIR [NIR_1] SIRET [SIRET_1]"

restored = anon.deanonymize_text(safe)
# → "NIR 267041305561777 SIRET 41021468800013"

Release files for maestro-core 1.5.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for maestro-core 1.5.1
File	Size	Uploaded
maestro_core-1.5.1.tar.gz	192.3 kB	Apr 5, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for maestro-core 1.5.1
File	Interpreter	ABI	Platform	Reset
maestro_core-1.5.1-py3-none-any.whl 276.2 kB Apr 5, 2026	Python 3	none	any	Details

Total release size: 468.5 kB

Release files / maestro_core-1.5.1.tar.gz

Download URL	maestro_core-1.5.1.tar.gz
Size	192.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`327bb7decb0909ff3cf2b22d7a6fee0d94f8c069b414ed3490896d8c34878ec0`
BLAKE2b-256 checksum How to use checksums	`88a04e9fb2b6e2c2ccab9c510cc87d08d3ea36faa1eb5a4674bb70a56ef06845`
Upload date	Apr 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.11.8`

Release files / maestro_core-1.5.1-py3-none-any.whl

Download URL	maestro_core-1.5.1-py3-none-any.whl
Size	276.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`e0e0aa8af28659dbe99d6e2456e73006daef97a43a47eb6e3a0ca288c3e4139d`
BLAKE2b-256 checksum How to use checksums	`ab8758f101ee96fcdcc6ab8c262f33c55d2700d29104c62484301e4bcceacfd6`
Upload date	Apr 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.11.8`