Metadata-Version: 2.4
Name: iterfact
Version: 0.1.2
Summary: Installable CLI and MCP server for IterFact interactive documents.
Author: IterFact
Keywords: iterfact,mcp,interactive-documents,artifacts
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp[cli]>=1.11.0
Requires-Dist: starlette>=0.46.0
Requires-Dist: uvicorn[standard]>=0.34.0
Requires-Dist: httpx>=0.28.0
Requires-Dist: boto3>=1.37.0
Requires-Dist: python-dotenv>=1.0.1
Requires-Dist: playwright>=1.54.0
Requires-Dist: claude-agent-sdk>=0.1.50
Requires-Dist: htmlmin>=0.1.12
Requires-Dist: rcssmin>=1.1.2
Requires-Dist: rjsmin>=1.2.2

# iterfact

Installable CLI and MCP server for IterFact interactive documents.

## Install

```bash
pip install iterfact
```

## Run

```bash
iterfact-mcp --host 0.0.0.0 --port 8000
```

Or:

```bash
iterfact mcp --host 0.0.0.0 --port 8000
```

## What it includes

- the IterFact MCP server
- the bundled IterFact template vault
- the CLI entrypoints needed to run IterFact locally

## Notes

- For local preview and screenshot features, install Chromium for Playwright:

```bash
python -m playwright install chromium
```

- Configure the required environment variables before running against your own services.

## Telemetry

The official CLI sends a small anonymous usage ping on:

- first successful local use
- then at most once per 24 hours per command

It includes package version, Python version, OS, entrypoint, and command name.
It does not send prompts, files, artifact contents, or account credentials.

Disable it with:

```bash
ITERFACT_NO_TELEMETRY=1
```

Package download analytics are measured separately through the public PyPI ecosystem:

- `pypistats.org`
- `pepy.tech`
- the official PyPI BigQuery dataset
