Skip to main content

No project description provided

Project description

Superagent Python SDK 🥷

The open framework for building AI Assistants

PyPi Fern GitHub Contributors GitHub Last Commit GitHub Issues GitHub Pull Requests Github License Discord


Superagent is an open source framework that enables any developer to integrate production ready AI Assistants into any application in a matter of minutes.


Installation

Add this dependency to your project's build file:

pip install superagent-py
# or
poetry add superagent-py

Usage

from superagent.client import Superagent

client = Superagent(token="API_TOKEN", base_url="https://api.beta.superagent.sh")

agent = client.agent.create(request={
    "name": "My Agent",
    "description": "My awesome agent",
    "isActive": True,
    "llmModel": "GPT_4_1106_PREVIEW",
    "prompt": "You are a helpful assistant"
})

output = client.agent.invoke(
    agent_id=agent.data.id,
    input="Hi there!",
    enable_streaming=False,
    session_id="123"
)

print("Received response from superagent", agent.data)

Async Client

from superagent.client import AsyncSuperagent

agent = await client.agent.create(request={
    "name": "My Agent",
    "description": "My awesome agent",
    "isActive": True,
    "llmModel": "GPT_4_1106_PREVIEW",
    "prompt": "You are a helpful assistant"
})

output = await client.agent.invoke(
    agent_id=agent.data.id,
    input="Hi there!",
    enable_streaming=False,
    session_id="123"
)

print("Received response from superagent", agent.data)

Handling Exceptions

All exceptions thrown by the SDK will sublcass moneykit.ApiError.

from superagent.core import ApiError

try:
  client.agents.get(agent_id="12312")
except APIError as e:
  # handle any api related error

Error codes are as followed:

Status Code Error Type
422 UnprocessableEntityError

Acknowledgements

A special thanks to the Fern team for all support with the Superagent libraries and SDKs ❤️.

Beta status

This SDK is in beta, and there may be breaking changes between versions without a major version update. Therefore, we recommend pinning the package version to a specific version in your pyproject.toml file. This way, you can install the same version each time without breaking changes unless you are intentionally looking for the latest version.

Contributing

While we value open-source contributions to this SDK, this library is generated programmatically. Additions made directly to this library would have to be moved over to our generation code, otherwise they would be overwritten upon the next generated release. Feel free to open a PR as a proof of concept, but know that we will not be able to merge it as-is. We suggest opening an issue first to discuss with us!

On the other hand, contributions to the README are always very welcome!

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

superagent_py-0.2.40.tar.gz (33.1 kB view details)

Uploaded Source

Built Distribution

superagent_py-0.2.40-py3-none-any.whl (83.6 kB view details)

Uploaded Python 3

File details

Details for the file superagent_py-0.2.40.tar.gz.

File metadata

  • Download URL: superagent_py-0.2.40.tar.gz
  • Upload date:
  • Size: 33.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.1 CPython/3.8.18 Linux/5.15.0-1064-azure

File hashes

Hashes for superagent_py-0.2.40.tar.gz
Algorithm Hash digest
SHA256 1f57e8cc8eb5b7387abcfc2c5b786985624ce56cfc8341b4ef352607f7224998
MD5 f2623c170a1650215d05a9f3f2a0f69b
BLAKE2b-256 5423b3e1064335d006df77dd6584db9d57a1f595831385c92fa5d88415b0df83

See more details on using hashes here.

File details

Details for the file superagent_py-0.2.40-py3-none-any.whl.

File metadata

  • Download URL: superagent_py-0.2.40-py3-none-any.whl
  • Upload date:
  • Size: 83.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.5.1 CPython/3.8.18 Linux/5.15.0-1064-azure

File hashes

Hashes for superagent_py-0.2.40-py3-none-any.whl
Algorithm Hash digest
SHA256 761aeb419161f79d5558d4e9fa46596309b37bd7154f5440987abeeeba5764f5
MD5 4046110a6441f538348a5fbaa8d607d1
BLAKE2b-256 59e43ed44db9d40f8b4044fcdc0221c09656421623cb019ab52a0e7e64f2004f

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page