# Quick Start Guide

Go from zero to your first successful agent run. If you have not installed and configured the SDK yet, run `pip install --upgrade glaip-sdk` (or follow [Install & Configure](https://gdplabs.gitbook.io/gl-aip/getting-started/install-and-configure)) before continuing.

{% hint style="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.
{% endhint %}

{% hint style="info" %}
Want runnable code that mirrors the latest SDK behavior? Jump to the [Hands-on Examples](https://gdplabs.gitbook.io/gl-aip/getting-started/hands-on-examples), which links to the validated projects.
{% endhint %}

### Paths

* [Python SDK](https://gdplabs.gitbook.io/gl-aip/getting-started/quick-start-guide/python-sdk) — programmatic control and notebooks.
* [CLI](https://gdplabs.gitbook.io/gl-aip/getting-started/quick-start-guide/cli) — quick experiments, scripting, and CI.

{% hint style="info" %}
Data developers who focus on prompt iteration can skip the SDK path and follow the CLI steps exclusively. Product managers typically validate agents in GLChat; run the CLI flow here when you need verbose traces, file attachments, or to reproduce an issue for engineering.
{% endhint %}

### Python SDK Path <a href="#python-sdk-path" id="python-sdk-path"></a>

Follow the [Python SDK](https://gdplabs.gitbook.io/gl-aip/getting-started/quick-start-guide/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.

### CLI Path <a href="#cli-path" id="cli-path"></a>

Follow the [CLI](https://gdplabs.gitbook.io/gl-aip/getting-started/quick-start-guide/cli) page for zero-code setup, palette usage, and running your first agent from the terminal.

### Troubleshooting

| Issue                | Solution                                                         |
| -------------------- | ---------------------------------------------------------------- |
| `command not found`  | Ensure pip’s script directory is on `PATH`, or reinstall with uv |
| `401 Unauthorized`   | Run `aip configure` 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

1. Practice with the [Hands-on examples](https://gdplabs.gitbook.io/gl-aip/getting-started/hands-on-examples) to explore tools, files, and multi-agent flows.
2. Check out the [GL SDK Cookbook](https://github.com/GDP-ADMIN/gl-sdk-cookbook) for self-contained, multi-tool examples like the Travel Assistant.
3. Deepen lifecycle control in the [Agents guide](https://gdplabs.gitbook.io/gl-aip/how-to-guides/agents-guide).
4. Wire up native and custom tooling via the [Tools guide](https://gdplabs.gitbook.io/gl-aip/how-to-guides/tools-guide).
5. Explore orchestration strategies in the [Multi-Agent System Patterns overview](https://gdplabs.gitbook.io/gl-aip/how-to-guides/multi-agent-system-patterns) once you need repeatable playbooks.