agami-core

The governed trust layer between an AI agent and your database. The importable core behind the agami Claude Code skill and MCP server — the semantic model, the shared MCP TOOLS harness, and the local query executor.

What it does

Point an AI agent at a database and it answers by guessing — at the join, at what "revenue" means, at which rows it's allowed to read. agami-core turns your schema into a governed semantic model where every join is FK-derived or human-approved and every metric is signed off before the runtime trusts it. Every answer then ships a receipt — the exact SQL it ran and the model version it pinned — so a silent join mistake never reaches you as a confident wrong number.

It runs locally: credentials, schema, and query results never leave your machine.

Most people don't pip install this

If you just want to use agami, install the Claude Code plugin — you don't touch this package directly:

/plugin marketplace add AgamiAI/agami-core
/plugin install agami-core@agami

pip install agami-core is for the other two audiences: importing the library into your own code, or self-hosting the MCP server. Full product docs and the plugin walkthrough live in the repository.

Install

pip install agami-core            # executor + stdio harness (pure-stdlib)
pip install 'agami-core[model]'   # + the semantic model (pydantic / sqlglot / pyyaml)
pip install 'agami-core[server]'  # + the networked HTTP MCP server (see below)

From a checkout, swap in the editable path — pip install -e 'packages/agami-core[model]'.

Importing the library

The top-level names — semantic_model, mcp_harness, execute_sql, agami_paths — are a deliberate flat invariant (no parent package, no sys.path juggling), so a consumer's imports resolve unchanged:

from mcp_harness import TOOLS
import semantic_model
import execute_sql

Module entry points:

python -m mcp_harness                        # the stdio MCP server (Claude Desktop)
python -m execute_sql --sql-file query.sql   # the local query executor
python -m semantic_model.cli                 # the semantic-model CLI (driven by the `sm` launcher)
python -m mcp_http                           # the networked HTTP MCP server (see below)

HTTP MCP server ([server]) — early access, in testing

The [server] extra adds a networked MCP transport: the same TOOLS surface as the stdio server, but over HTTP with OAuth and a small admin console. It's the self-host shape of the hosted product — deploy it to your own host and a whole team connects their own Claude to one URL, zero-egress by default (enabling OIDC/SSO adds one outbound call to your identity provider).

🧪 Early access. This team/server layer is usable today but newer than the local single-player path — expect the occasional rough edge, and please report anything broken via a GitHub issue. The local library and stdio server are the stable path.

A minimal local launch (SQLite store, password admin):

PUBLIC_BASE_URL=https://your-host \
AGAMI_SIGNING_SECRET=$(openssl rand -hex 32) \
AGAMI_DB_URL=sqlite:///$PWD/agami.db \
AGAMI_ADMIN_USERNAME=you@example.com AGAMI_ADMIN_PASSWORD=choose-a-strong-one \
python -m mcp_http

The full detail — the auth/access model, OIDC onboarding, the admin console (Activity + Model views), and every environment variable — lives in the docs rather than here:

Links

  • Repository & full docs — github.com/AgamiAI/agami-core
  • Homepage — agami.ai
  • License — fair-code (source-available), the Agami Functional Use License. Self-hosting for your own organization is free; serving people outside it needs a commercial license.

Project links

Data verified by PyPI on Sep 12, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.8.6)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for agamiai from gravatar.com agamiai

Credits

Author: Agami AI

GitHub Statistics

Data verified by PyPI on Sep 12, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

LicenseRef-Agami-FUL
View SPDX License List

Requires

Python >=3.10

Provides Extra

model server

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agami_core-0.8.4.tar.gz (655.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agami_core-0.8.4-py3-none-any.whl (688.3 kB view details)

Uploaded Python 3

File details

Details for the file agami_core-0.8.4.tar.gz.

File metadata

  • Download URL: agami_core-0.8.4.tar.gz
  • Upload date:
  • Size: 655.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for agami_core-0.8.4.tar.gz
Algorithm Hash digest
SHA256 a76fb3f16bba8cb16ffd2c94b89894adfba95c5abb4898f524e191ffef40f8c6
MD5 f78641135883d9599665cff637815396
BLAKE2b-256 e283176d78e7db80e15a17429d0fccec23de65c0f67a1c5954c0f5db2832de9c

See more details on using hashes here.

Provenance

The following attestation bundles were made for agami_core-0.8.4.tar.gz:

Publisher: release-pypi.yml on AgamiAI/agami-core

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agami_core-0.8.4-py3-none-any.whl.

File metadata

  • Download URL: agami_core-0.8.4-py3-none-any.whl
  • Upload date:
  • Size: 688.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for agami_core-0.8.4-py3-none-any.whl
Algorithm Hash digest
SHA256 5e2f8cc42a3bc8102d0a34e3eabe208cd13fd5a76a2b8b0e8cca510a83738946
MD5 5ba5047777f1e3eb6272a154a126f41a
BLAKE2b-256 47ad15651ce090911117297e1d57b294ed7d3f7c83fd69e668e9345c2c042202

See more details on using hashes here.

Provenance

The following attestation bundles were made for agami_core-0.8.4-py3-none-any.whl:

Publisher: release-pypi.yml on AgamiAI/agami-core

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.8.6

2 files

0.8.5

2 files

This release

0.8.4 This release

2 files

0.8.3

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

2 files

0.7.1

2 files

0.7.0

2 files

0.6.9

2 files

0.6.8

2 files

0.6.7

2 files

0.6.6

2 files

0.6.5

2 files

0.6.4

2 files

0.6.3

2 files

0.6.2

2 files

0.6.1

2 files

0.6.0

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

0.4.5

2 files

0.4.4

2 files

0.4.3

2 files

0.4.2

2 files

0.4.1

2 files

0.4.0

2 files

0.3.9

2 files

0.3.8

2 files

0.3.7

2 files

0.3.6

2 files

0.3.5

2 files

0.3.4

2 files

0.3.3

2 files

0.3.2

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page