semvec/pypi-packages huggingface dataset:
modekeeper 0.1.27
ModeKeeper: verify-first, customer-safe read-only agent; apply is licensed and gated
Requires Python: >=3.10
Keywords: mlops, observability, autotuning, safety

# ModeKeeper

[![CI](https://github.com/abcexpert/modekeeper/actions/workflows/ci.yml/badge.svg)](https://github.com/abcexpert/modekeeper/actions/workflows/ci.yml)
[![PyPI](https://img.shields.io/pypi/v/modekeeper.svg)](https://pypi.org/project/modekeeper/)

ModeKeeper is a verify-first operations agent for SRE, MLOps, and FinOps teams. The public runtime is customer-safe and read-only by default; apply is licensed and hard-gated.

## Contact
Documentation index: [`docs/INDEX.md`](docs/INDEX.md)


- Questions / feedback: GitHub Issues (preferred) and Discussions.
- Security issues: please use GitHub Security Advisories (private disclosure). See `.github/SECURITY.md`.

## Start here

- Buyer journey: [`docs/BUYER_JOURNEY.md`](docs/BUYER_JOURNEY.md)
- Product overview: [`docs/product.md`](docs/product.md)
- Quickstart: [`docs/QUICKSTART.md`](docs/QUICKSTART.md)
- Security posture: [`docs/SECURITY_POSTURE.md`](docs/SECURITY_POSTURE.md)
- Buyer proof pack: [`docs/BUYER_PROOF_PACK.md`](docs/BUYER_PROOF_PACK.md)
- Procurement pack: [`docs/PROCUREMENT_PACK.md`](docs/PROCUREMENT_PACK.md)
- Enterprise evaluation: [`docs/ENTERPRISE_EVALUATION.md`](docs/ENTERPRISE_EVALUATION.md)
- Current project status: [`docs/STATUS.md`](docs/STATUS.md)
- Workflow details: [`docs/WORKFLOW.md`](docs/WORKFLOW.md)
- Distribution boundary policy: [`docs/DISTRIBUTION_POLICY.md`](docs/DISTRIBUTION_POLICY.md)

## 60-second quickstart

```bash
python3 -m pip install -U modekeeper
mk --help
mk observe --source synthetic --duration 10s --out report/quickstart/observe
mk closed-loop run --scenario drift --observe-source synthetic --observe-duration 10s --dry-run --out report/quickstart/plan
mk export bundle --in report/quickstart --out report/quickstart/export

# quickstart artifacts
ls report/quickstart
ls report/quickstart/observe
ls report/quickstart/plan
ls report/quickstart/export
```

Expected artifact roots:
- `report/quickstart/observe` (read-only telemetry capture)
- `report/quickstart/plan` (dry-run planning outputs)
- `report/quickstart/export` (bundle/export outputs)

## Safety gates

Apply/mutate paths are blocked unless all required gates pass:
- `verify_ok=true` from verify artifacts
- kill-switch is absolute (`MODEKEEPER_KILL_SWITCH=1` blocks apply)
- valid license and apply entitlement

Details and command contracts:
- [`docs/QUICKSTART.md`](docs/QUICKSTART.md)
- [`docs/WORKFLOW.md`](docs/WORKFLOW.md)

## Public vs Pro

Public GitHub + PyPI (`modekeeper`) is the showroom/stub surface with verify-first workflows (`observe -> plan -> verify -> ROI -> export`). Apply/mutate capabilities are disabled by default in public and reserved for licensed distribution; see boundary and release rules in [`docs/DISTRIBUTION_POLICY.md`](docs/DISTRIBUTION_POLICY.md).
dolomite-cli 1.0.0
CLI tool for querying Dolomite protocol data across all chains
Requires Python: >=3.10
Keywords: blockchain, cli, defi, dolomite, interest-rates

# dolomite CLI

Query Dolomite protocol data across all chains. Returns structured JSON. No API keys required.

## Install

```bash
pipx install dolomite-cli
```

Or with pip:

```bash
pip install dolomite-cli
```

Requires Python 3.10+. Zero dependencies (stdlib only).

### From source

```bash
git clone https://github.com/openclaw/dolomite-cli
cd dolomite-cli
pip install -e .
```

## Commands

| Command | Description |
|---------|-------------|
| `dolomite rates` | All markets with supply/borrow rates |
| `dolomite positions` | Top borrowing positions by size |
| `dolomite flows` | Recent large deposits/withdrawals |
| `dolomite liquidations` | Recent liquidation events |
| `dolomite tvl` | Protocol TVL summary per chain |
| `dolomite markets --token USDC` | Detailed info for a specific token |
| `dolomite account <address>` | Full position detail for an address |
| `dolomite risks` | High-risk positions and utilization alerts |
| `dolomite schema` | Show all commands, chains, entities, examples |

## Examples

```bash
# Stablecoin rates across all chains
dolomite rates --stables-only

# Top 20 positions on Ethereum
dolomite positions --chain ethereum --top 20

# Whale flows in the last 48 hours
dolomite flows --hours 48 --min-usd 100000

# Deposits only
dolomite flows --type deposit --hours 72

# Look up a specific whale
dolomite account 0x8be46b25d59616e594f0a9e20147fb14c1b989d9

# High-risk positions (>80% LTV, >$100K)
dolomite risks --min-ltv 80 --min-usd 100000

# Berachain rates only
dolomite rates --chain berachain

# USDC across all chains
dolomite markets --token USDC
```

## Output

All commands output JSON to stdout. Errors go to stderr. Pipe to `jq` for filtering:

```bash
# Top 5 stablecoin rates
dolomite rates --stables-only | jq '.markets[:5][] | {chain, symbol, supply_rate_pct}'

# Total protocol TVL
dolomite tvl | jq '.total_supply_usd'

# Addresses with >85% LTV
dolomite risks --min-ltv 85 | jq '.high_ltv_positions[] | {address, ltv_pct, supply_usd}'
```

## Chains

| Chain | Chain ID | Status |
|-------|----------|--------|
| Ethereum | 1 | Active (~$370M TVL) |
| Arbitrum | 42161 | Active (~$52M TVL) |
| Berachain | 80094 | Active (~$50M TVL) |
| Mantle | 5000 | Minimal |
| Base | 8453 | Minimal |
| X Layer | 196 | Minimal |

Default: queries Ethereum, Arbitrum, Berachain. Use `--chain all` for everything.

## Data Sources

- **Subgraph API**: `subgraph.api.dolomite.io` — on-chain positions, flows, liquidations
- **REST API**: `api.dolomite.io` — token prices, interest rates, market data

No authentication required. All data is public.

## For AI Agents

Run `dolomite schema` to get a complete description of all commands, available entities, and example queries. The output is JSON — parseable by any model.