Skip to main content
By the end you will have a deployed service reachable at https://<endpoint-id>.svc.uniac.ai.

Prerequisites

  • Python 3.11 or newer
  • Node 16 or newer (to install the CLI via npm)
  • Docker (for uniac dev)

1. Install the CLI and SDK

2. Log in

This opens a browser to complete the sign-in flow and writes a token to ~/.uniac/auth.json.

3. Scaffold a project

uniac init is interactive — pick app for the kind, Python for the language, and accept the default entrypoint. The result is a uniac.json manifest and a starter app.py. Replace app.py with a minimal System:
app.py
Add a requirements.txt:
requirements.txt

4. Run it locally

The simulator starts a local Docker stack and opens the dashboard. Send GET /hello?name=cloud from the dashboard’s request panel.

5. Deploy

uniac link binds the project to a remote Uniac project (created on the fly if it doesn’t exist). uniac deploy builds, pushes the image, and registers the deployment. The CLI prints the public URL on success:
Call it:

Next steps

Your first service

The same flow with deeper explanations.

Concepts

Services, Systems, Nodes, projects, deployments.