2026-07-16 21:13 UTCIn-site rewrite4 min readUpdated: 2026-07-16 21:17 UTC

Skyportal SRE – an open-source AI infrastructure engineer

Skyportal SRE is an open-source AI infrastructure engineer tool providing a Python SDK, CLI, and observability agent for managing and monitoring AI infrastructure.

SourceHacker News AIAuthor: mattskyportal

Uh oh!

There was an error while loading. Please reload this page.

Notifications You must be signed in to change notification settings

Fork 0

Star 0

BranchesTags

Open more actions menu

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

2 Commits

.github

docs

skyportal

skyportalai

tests

.editorconfig

.gitattributes

.gitignore

.python-version

CODE_OF_CONDUCT.md

CONTRIBUTING.md

LICENSE

README.md

SECURITY.md

poetry.lock

pyproject.toml

run.sh

Repository files navigation

The official Python SDK and persistent terminal client for the SkyPortal API.

Project status: Alpha. APIs may evolve before 1.0; changes are documented in GitHub releases.

User app → skyportalai (SDK) → SkyPortal HTTP API

Install

pip install skyportalai

or

poetry add skyportalai

Requires Python 3.11+.

The local observability agent has one additional dependency set:

pip install "skyportalai[agent]"

Quickstart

from skyportalai import Skyportal

client = Skyportal(api_key="sk-...") # or set SKYPORTAL_API_KEY user = client.me() print(user.name)

Skyportal can be used as a context manager when the SDK owns the HTTP session:

with Skyportal(api_key="sk-...") as client: print(client.me().name)

Drive the ops agent

client.chat wraps the headless agent API: create a chat, poll it, resolve approvals, and read the run's messages — the agent itself runs server-side.

chat = client.chat.create_chat("check disk usage on the training node", server_id=12)

Poll until the agent settles; approve any command it asks to run.

status = chat.wait(on_approval=lambda a: True) # True approves, False rejects print(status.status) # "idle"

for m in chat.messages().messages: print(f"{m.role}: {m.content}")

Without an on_approval callback, wait() returns as soon as the agent needs a decision, and you resolve it yourself:

status = chat.wait() if status.status == "awaiting_approval": for approval in status.pending_approvals: print("agent wants to run:", approval.command) chat.approve(approval.approval_id, command=approval.command) status = chat.wait()

Follow-ups go through chat.send("..."); chat.cancel() stops an active run. Read-only introspection mirrors the observability endpoints: chat.events(), chat.tool_calls(), chat.reasoning(), chat.plans(), chat.evaluations(), chat.environment().

wait() raises WaitTimeoutError if the agent is still busy past timeout (default 300s).

Configuration

Argument Env var Default Notes

api_key SKYPORTAL_API_KEY — required; sent as Authorization: Bearer

base_url SKYPORTAL_BASE_URL https://app.skyportal.ai API root; trailing slash optional

timeout — 30.0 per-request seconds

max_retries — 2 retries for GET on network error / 5xx

client = Skyportal(api_key="sk-...", base_url="http://localhost:8000", timeout=10)

Remote targets must use HTTPS because every request carries a Bearer key. Plain HTTP is accepted for loopback development only. Valid self-hosted HTTPS deployments are fully supported.

Errors

Every failure is a skyportalai exception — a raw requests error never escapes:

from skyportalai import Skyportal, AuthenticationError, APIConnectionError, APIError

try: Skyportal(api_key="bad").me() except AuthenticationError: ... # 401/403, or the key was rejected except APIConnectionError: ... # network failure / timeout except APIError as e: ... # other non-2xx; e.status_code, e.body

Hierarchy: SkyportalError ▸ APIConnectionError, APIStatusError ▸ AuthenticationError, APIError.

Command-line clients

The package installs two complementary commands:

skyportal is the interactive command center, with login, server selection, persistent chat state, and approval prompts.

skyportalai is the script-friendly Typer CLI, with stable --json output for chat and configuration operations.

Interactive terminal

skyportal # start the interactive command center skyportal start # same as above skyportal login # browser-guided API-key setup skyportal login --token # paste an existing credential skyportal ask "List my hosts" skyportal ask --server 42 "Show disk usage" skyportal servers skyportal logout skyportal configure --portal-url https://your-skyportal.example

For a self-installing local launcher, clone the repository and run ./run.sh. It provisions a virtual environment, installs this package, displays the animated Skyportal astronaut, and opens the command center.

At the interactive prompt, /login opens the API-key page and guides you through connecting the terminal. Credentials are validated before being stored in ~/.skyportal/credentials.json with user-only permissions.

Interactive commands:

/help Show commands /login Open API-key setup and connect /token Reopen API-key setup and paste a credential /logout Remove the saved credential /status Show API, chat, and server context /new Start a new agent chat /servers List owned servers /server Select a server for agent execution /server auto Let the agent choose a server /clear Clear the terminal /exit Exit

CLI configuration is stored in ~/.skyportal/config.yaml. Environment overrides include SKYPORTAL_URL, SKYPORTAL_ACCESS_TOKEN, SKYPORTAL_CONFIG_PATH, SKYPORTAL_CREDENTIALS_PATH, SKYPORTAL_HISTORY_PATH, SKYPORTAL_NO_ANIMATION, and SKYPORTAL_ANIMATION_SPEED.

See CLI architecture and CLI deployment for more detail.

Automation CLI

skyportalai config show skyportalai chat send --server 42 --wait "Show disk usage" skyportalai chat status 123 skyportalai --json chat messages 123

Run skyportalai --help or skyportalai chat --help for the full command reference. It uses SKYPORTAL_API_KEY first and can also read credentials saved by skyportal login.

Observability agent

skyportal-agent discovers W&B and MLflow experiment metadata, buffers it in a disk-backed queue, and uploads it with bounded retries. Its config/tag redaction removes credential-like values before persistence, but operators must still restrict scan roots and protect the state directory.

See observability agent deployment and data handling before running it on experiment volumes.

Development

poetry install --all-extras poetry run pytest poetry run ruff check . poetry check --strict

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md for development setup, tests, and the pull request process, and CODE_OF_CONDUCT.md for community expectations. Supported Python versions are 3.11, 3.12, and 3.13.

Security

Do not open a public issue for a vulnerability. Follow the private reporting instructions in SECURITY.md.

License

Released under the MIT License.

About

SkyPortal SDK & CLI - Open Source

skyportal.ai

Topics

kubernetes

devops

machine-learning

grafana

inference

prometheus

artificial-intelligence

openai

sre

gpu-monitoring

otel

mlops

opentelemetry

ai-observability

anthropic

vllm

llm-observability

Resources

Readme

License

MIT license

Code of conduct

Contributing

Security policy

Uh oh!

There was an error while loading. Please reload this page.

Activity

Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks

Report repository

Releases

No releases published

Packages 0

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

Python 99.0%

Shell 1.0%