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 Aug 27, 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 Aug 27, 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.6.8.tar.gz (598.6 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.6.8-py3-none-any.whl (626.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: agami_core-0.6.8.tar.gz
  • Upload date:
  • Size: 598.6 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.6.8.tar.gz
Algorithm Hash digest
SHA256 24f03f5a904dc993bc72055e5c02b689a2597e33ee1d438aa322e02ff988ccd3
MD5 4986fc9d5f2d2f9afe15020051ab6731
BLAKE2b-256 5017bc561736803af8bbe34c75edd2086fc9781d7f5b9ffde13f97369484b99b

See more details on using hashes here.

Provenance

The following attestation bundles were made for agami_core-0.6.8.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.6.8-py3-none-any.whl.

File metadata

  • Download URL: agami_core-0.6.8-py3-none-any.whl
  • Upload date:
  • Size: 626.2 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.6.8-py3-none-any.whl
Algorithm Hash digest
SHA256 c4f54e2eeaec273536d5163cedb1975e276a080042dabeae7e38a7b87c4afd89
MD5 790019cdc58c8327566c856886b209b8
BLAKE2b-256 2420f26ddc98904e7ed83313a6c8aad6c883f48b08c3a852153a0ec930e64737

See more details on using hashes here.

Provenance

The following attestation bundles were made for agami_core-0.6.8-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

0.8.4

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

This release

0.6.8 This release

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