Metadata-Version: 2.4
Name: swisstip-quickstart
Version: 0.3.2
Summary: Swiss TIP quickstart: fetch a published knowledge pack, verify it against its readiness record and run the first tests
Author: Alexander Bobrovsky
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/swisstip/swiss-tip
Project-URL: Source, https://github.com/swisstip/swiss-tip
Project-URL: Issues, https://github.com/swisstip/swiss-tip/issues
Keywords: mcp,grounding,switzerland,quickstart
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.14
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: pyyaml<7,>=6
Requires-Dist: swisstip-calendar-connector==0.3.2
Requires-Dist: swisstip-core==0.3.2
Requires-Dist: swisstip-mcp==0.3.2
Dynamic: license-file

# swisstip-quickstart

**Last update:** 24 September 2026

The one command that serves and tests a published Swiss TIP knowledge pack
on your machine. It fetches the pack from its public repository, verifies
every file against the pack's readiness record, and runs the first tests
with no model and no further network: the release validates, the semantic
index is bound to it, the pack's acceptance suite and regression pack are
replayed against it, and a client round trip runs over MCP against the
server. It ends with the commands that serve the pack and connect an MCP
client.

## Use

Python 3.14 or newer. With [uv](https://docs.astral.sh/uv/), `uvx` fetches
the command and a matching Python on first use, in any directory:

```bash
uvx swisstip-quickstart mvp-zurich                # fetch into ./.local/packs/mvp-zurich, check, test
uvx swisstip-quickstart mvp-zurich --serve        # then serve on http://127.0.0.1:8000/mcp
uvx swisstip-quickstart mvp-zurich --no-fetch     # the checks and tests again, offline
uvx swisstip-quickstart --url http://127.0.0.1:8000/mcp   # the round trip against a running server
```

The pack is the argument; the packs of the MVP are published in
[swiss-tip-mvp](https://github.com/swisstip/swiss-tip-mvp), and `--ref`
names a commit or tag of it. `--help` lists the rest.

## Related packages

- `swisstip-mcp`: the MCP server the quickstart tests and serves with.
- `swisstip-core`: the release format, validator and tool operations.

Requires `swisstip-core` and `swisstip-mcp` at the same version. Licence:
Apache-2.0.
