Quick Start Guide

Go from zero to your first successful agent run.

If you have not installed and configured the SDK yet, start with Install & Configure.

Success

When to use this guide: Choose it when you need a reproducible walkthrough to prove connectivity, create an agent, and observe responses without diving into advanced configuration.

Audience: Developers, PMs running acceptance demos, and data developers validating prompt baselines.

If you need a deeper comparison before choosing, read Local vs Remote.

Default Path: Python SDK

Follow the Python SDK page for step-by-step installation, a default local agent run, and optional setup when you want to target a remote AIP server with API credentials and deployment.

Info

If you prefer a low-code workflow (operators, demos, CI smoke tests), use the CLI section:

• CLI entry: CLI

• Quick start (CLI): CLI Quick Start

Troubleshooting

Issue	Solution
command not found	Ensure pip's script directory is on PATH, or reinstall with uv
401 Unauthorized	Run aip accounts add <name> and aip accounts use <name>, or update your environment variables
404 Not Found	Check your API URL with aip accounts show <name>
Connection refused	Confirm the remote AIP server is reachable
uv not found	Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh

Next Steps

Suggested Sequence

1. Complete either the Python SDK quick start or CLI quick start.

2. Confirm at least one successful response from your agent.

3. Move to the corresponding guide track: Agents, Tools, MCPs.

Troubleshooting Quick Checks

Issue	Fast fix
command not found (aip)	Ensure pip's script directory is on PATH, or reinstall using uv tool install glaip-sdk
401 Unauthorized	Run aip accounts add <name> and aip accounts use <name>, or update environment variables
404 Not Found	Verify API URL with aip accounts show <name>
Connection refused	Confirm AIP server reachability and network/proxy settings
uv not found	Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh

What to Read Next

1. Hands-on examples for runnable patterns.

2. Agents for lifecycle and runtime controls.

3. Configuration management for export/import promotion loops.

4. CLI reference for flags and automation.