> For the complete documentation index, see [llms.txt](https://docs.concurrence.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.concurrence.com/developer-guide/classic-api/sdks.md).

# Classic SDKs

Official Python and TypeScript SDKs for the Classic API with streaming, auth, and error handling.

These SDK pages cover the Classic API SDKs in Python and TypeScript. The SDKs take care of authentication, request formatting, response parsing, and error handling so you can focus on building AI-powered applications.

{% hint style="warning" %}
**Classic API only.** These SDKs wrap the Classic API at `api.amigo.ai`. For the Platform API (`api.platform.amigo.ai`), use the [Platform SDK](/developer-guide/platform-api/platform-sdk.md) for TypeScript or direct HTTP while additional first-party Platform SDKs are added.
{% endhint %}

## Available SDKs

### Python SDK

The official Python SDK for the Concurrence API, supporting both synchronous and asynchronous operations.

| Property            | Value                                                                                            |
| ------------------- | ------------------------------------------------------------------------------------------------ |
| **Package**         | `amigo_sdk`                                                                                      |
| **Current Version** | 2.0.1                                                                                            |
| **Repository**      | [github.com/concurrence-hq/amigo-python-sdk](https://github.com/concurrence-hq/amigo-python-sdk) |
| **Registry**        | [PyPI](https://pypi.org/project/amigo_sdk/)                                                      |
| **Python Version**  | 3.11+                                                                                            |

### TypeScript SDK

The official TypeScript/JavaScript SDK for the Concurrence API, with full type safety and modern async/await patterns.

| Property            | Value                                                                                                    |
| ------------------- | -------------------------------------------------------------------------------------------------------- |
| **Package**         | `@amigo-ai/sdk`                                                                                          |
| **Current Version** | 2.1.0 (the accidental `1.1.x` npm versions remain deprecated)                                            |
| **Repository**      | [github.com/concurrence-hq/amigo-typescript-sdk](https://github.com/concurrence-hq/amigo-typescript-sdk) |
| **Registry**        | [npm](https://www.npmjs.com/package/@amigo-ai/sdk)                                                       |
| **Node.js Version** | 18+                                                                                                      |

## Key Features

Both SDKs provide:

* **Auto-generated types.** Each release contains a generated snapshot of the [Concurrence OpenAPI schema](https://api.amigo.ai/v1/openapi.json) reviewed for that release.
* **Streaming support.** Real-time conversation events with built-in NDJSON parsing.
* **Error handling.** Typed error handling for all API responses.
* **Authentication.** Automated API key-based authentication and token management.
* **Configuration.** Environment variable support with flexible configuration options.
* **Resource helpers.** Helpers cover conversations, users, services, organizations, agents, and context graphs. Check the current operation for interfaces without a helper.

## API Compatibility

{% hint style="warning" %}
**Version compatibility.** Classic 2.0.0 refreshes generated contracts and removes obsolete schema fields or values. Recompile TypeScript consumers and validate Python model parsing against the operations you use. A published snapshot does not automatically follow later server changes. See [SDK release details](https://docs.concurrence.com/api-reference/change-logs/sdk-ecosystem#september-2026-compatibility-releases).
{% endhint %}

## Getting Started

1. [**Installation**](/developer-guide/classic-api/sdks/sdk-installation.md)**.** Set up the SDK in your project.
2. [**Configuration**](/developer-guide/classic-api/sdks/sdk-configuration.md)**.** Configure authentication and client options.
3. [**Hello World**](/developer-guide/classic-api/sdks/sdk-hello-world.md)**.** Create your first conversation.
4. [**Error Handling**](/developer-guide/classic-api/sdks/sdk-error-handling.md)**.** Handle errors and edge cases.

### Going Further

* [**Streaming Responses**](/developer-guide/classic-api/core-api/conversations/conversations-interact.md)**.** Handle real-time events.
* [**User Management**](/developer-guide/classic-api/core-api/users.md)**.** Create and manage users.
* [**Regional Endpoints**](/developer-guide/getting-started/regions-and-endpoints.md)**.** Configure regional deployments.

## Production Examples

The SDK repositories include working examples that demonstrate production-ready patterns.

{% tabs %}
{% tab title="Python Examples" %}
**Repository:** [github.com/concurrence-hq/amigo-python-sdk/examples](https://github.com/concurrence-hq/amigo-python-sdk/tree/main/examples)

* Project structure best practices
* Environment configuration
* Error handling patterns
* Async/await implementations
  {% endtab %}

{% tab title="TypeScript Examples" %}
**Repository:** [github.com/concurrence-hq/amigo-typescript-sdk/examples](https://github.com/concurrence-hq/amigo-typescript-sdk/tree/main/examples)

* Type-safe implementations
* Modern async patterns
* Production error handling
* Real-world application contexts
  {% endtab %}
  {% endtabs %}

## Support & Resources

| Resource                  | Link                                                                           |
| ------------------------- | ------------------------------------------------------------------------------ |
| **Python SDK Issues**     | [GitHub Issues](https://github.com/concurrence-hq/amigo-python-sdk/issues)     |
| **TypeScript SDK Issues** | [GitHub Issues](https://github.com/concurrence-hq/amigo-typescript-sdk/issues) |
| **Enterprise Support**    | Contact support through the Concurrence dashboard                              |
| **API Reference**         | [OpenAPI Schema](https://api.amigo.ai/v1/openapi.json)                         |

## License

Both SDKs are licensed under the MIT License.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.concurrence.com/developer-guide/classic-api/sdks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.