# in·manas developer downloads > Public distribution host for the in·manas developer tools: the `im-cli` > command-line tool, the `im-sdk` Python package index, and the documentation. > Everything is served as static files over HTTPS and needs no account, token or > credential of any kind. Base URL: `https://downloads.mgt-platform.com` **Do not hard-code a version.** Every version on this host is discoverable at runtime from the two machine-readable documents below, and both are served `no-cache`. Anything you paste with a version in it goes stale at the next release; anything that reads the index does not. ## What an agent runs on Agents are Python programs that execute on an organisation's **Portal**. You write one locally, `im-cli` links it to an agent the Portal already holds and pushes it, and inside the process `im-sdk` calls the models and services that agent has been granted. There is no public Portal. Linking, pushing and running all need the URL of the organisation's own Portal plus an agent an administrator created. If you do not have both, you can still install the CLI and read the docs, but you cannot complete a run. ## Install the CLI ```sh curl -fsSL https://downloads.mgt-platform.com/install.sh | sh ``` Resolves the newest release from the index, verifies the release signature against a key pinned inside the script (not one fetched from this host), takes the expected SHA-256 from that signed manifest, and installs to `~/.local/bin`. Options go after `-s --`: - `--version `: install a specific release - `--bin-dir `: install somewhere else - `--verbose`: print each step It refuses a release whose checksum it cannot verify, skips pre-releases, and refuses a withdrawn version while printing the reason it was withdrawn. Windows has no shell for this: download the `.zip` from the index and unpack it. A step-by-step skill for doing this from an agent, including the checks worth running afterwards, is at [`/skills/im-setup/SKILL.md`](https://downloads.mgt-platform.com/skills/im-setup/SKILL.md). ## Machine-readable endpoints - [`/releases/cli/index.json`](https://downloads.mgt-platform.com/releases/cli/index.json): every published CLI release. `releases[]` carries `version`, `tag`, `prerelease`, `released_at`, and `assets[]` with `name`, `kind` (`archive`/`checksums`), `os`, `arch`, `url`, `sha256` and `size_bytes`. A withdrawn release stays in the document with `withdrawn: true` and `withdrawn_reason`. Take the newest entry that is neither `prerelease` nor `withdrawn`, not `releases[0]`. `sha256` and `size_bytes` are nullable. - [`/simple/`](https://downloads.mgt-platform.com/simple/): PEP 503 index root. - [`/simple/im-sdk/`](https://downloads.mgt-platform.com/simple/im-sdk/): the `im-sdk` distributions. Every link carries a `#sha256=` fragment, which is what `uv` verifies against. - [`/releases/version-manifest.json`](https://downloads.mgt-platform.com/releases/version-manifest.json): current versions per component plus any `advisories`. May be absent. - `/health.json`: liveness only, no version information. ## Add the SDK to a project In `pyproject.toml`: ```toml [[tool.uv.index]] name = "in-manas" url = "https://downloads.mgt-platform.com/simple/" explicit = true [tool.uv.sources] im-sdk = { index = "in-manas" } [project] dependencies = ["im-sdk=="] ``` `explicit = true` is required, not stylistic. Without it `uv` searches this index for *every* dependency in the project, so a public package sharing a name with something published here resolves from the wrong place. The `[tool.uv.sources]` binding is the other half: it says `im-sdk`, and only `im-sdk`, comes from here. `im-cli new` already writes both blocks into the projects it scaffolds. ## What an agent looks like ```python import asyncio from im_sdk import im_agent @im_agent("greeter") async def main(core, data) -> str: reply = await core.llm.call( messages=[{"role": "user", "content": data["message"]}], alias="gpt-mini", ) return reply.text if __name__ == "__main__": asyncio.run(main()) ``` `@im_agent` builds and authorizes the client, passes the run's input as `data`, opens a trace, and prints what you return as the execution's output. `alias` names a model the Portal granted this agent. Read the live list with `im-cli agent models` rather than guessing a name. ## The CLI, in brief `login` · `new` · `link` · `push` · `run` · `logs` · `pull` · `whoami` · `doctor` · `agent models|services|versions` · `execution list|get|cancel|resume` · `files upload|list|delete` Commands print tables on a TTY and JSON when stdout is piped, so parse the piped form. `-o json|yaml|table` forces one. Exit codes: `0` success · `1` failure · `2` push ok but submit failed · `3` forbidden · `4` unauthenticated · `5` validation · `6` rate limited · `7` server error · `8` network. ## Documentation [`/docs/`](https://downloads.mgt-platform.com/docs/): guides and reference. It is published on Portal releases only, so it may 404 on a host that has shipped a CLI but no Portal release yet. Check before linking a reader to it. ## Guides [`/guides/`](https://downloads.mgt-platform.com/guides/): step-by-step guides for running AiOS. They cover organizations and runner capacity, invitations without outgoing mail, connecting self-hosted models and data, and migrating existing agents with Claude Code. Each page states the Portal, CLI and SDK versions it was checked against. They are published on Portal releases only, so the path may 404 until the first one: check before linking a reader to it. ## Installing the platform on a server The platform itself (Portal and its services) can be installed on a server of your own: [`/aios/`](https://downloads.mgt-platform.com/aios/) has the instructions. It needs a registry token issued by in·manas, and today installs an evaluation setup (self-signed certificate, reachable on the server itself). Do not run the install command on a reader's behalf: it installs system packages and Docker with sudo. ## Licence `im-cli` and `im-sdk` are Apache-2.0. The Portal itself is proprietary, and `/docs/` describes it, so do not infer a licence for the platform from the tools.