PinionAI Python Library
This is the official Python client library for the PinionAI platform. It provides a convenient, asynchronous way to interact with PinionAI agents, manage sessions, and use its various features including AI interactions and gRPC messaging. AI Agent authoring is performed in PinionAI Studio.
Website and Documentation
Github PinionAI Agent Examples - reflex/fastapi
Github PinionAI Agent Examples - streamlit, cli, slack, teams
Installation
From PyPI
This package is available on PyPI and can be installed with pip or uv. We recommend uv for its speed.
With uv
If you don't have uv, you can install it from astral.sh.
# On macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
#OR
brew install uv
# On Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
Once uv is installed, you can install the pinionai package from PyPI:
uv pip install pinionai
With pip
If you prefer to use pip, you can still install the package with:
pip install pinionai
From GitHub
To install the latest development version directly from the GitHub repository:
pip install git+https://github.com/pinionai/pinionai-package.git
Optional Features
The base install covers the common client and session workflow. Optional integrations are grouped into extras so you can keep the install lean and only pull in the packages you need.
- gcp: Google Cloud Storage support (google-cloud-storage)
- aws: AWS S3 support (boto3)
- openai: Support for OpenAI models (openai)
- anthropic: Support for Anthropic models (anthropic)
- javascript: Support for running JavaScript snippets (mini-racer)
- sendgrid: Support for running SendGrid delivery
- twilio: Support for SMS delivery
- telnyx: Support for SMS delivery
- data: Tabular and CSV helpers (pandas)
- google: Google Gemini / Vertex AI support (google-genai)
To install one or more optional features, specify them in brackets. For example, to get support for GCP, AWS, and Google AI:
pip install "pinionai[gcp,aws,google]"
To install all optional features at once, use the all extra:
pip install "pinionai[all]"
Options include:
- dev = [ "build", "twine", "ruff", "grpcio-tools", ]
- gcp = ["google-cloud-storage"]
- aws = ["boto3"]
- openai = ["openai"]
- anthropic = ["anthropic"]
- javascript = ["mini-racer"]
- sendgrid = ["sendgrid"]
- twilio = ["twilio"]
- data = ["pandas"]
- google = ["google-genai>=1.72.0"]
- all = [ "pinionai[gcp,aws,openai,anthropic,javascript,twilio,sendgrid,mcp,data,postgres,google]" ]
Adding to Requirements
To add this library to your project's requirements file, you can use the following formats.
For requirements.txt or requirements.in:
# For a specific version from PyPI
pinionai==0.4.7
# With optional features
pinionai[gcp,openai]==0.4.7
# From the main branch on GitHub
git+https://github.com/pinionai/pinionai-package.git@main
Usage
Here's a Github link to a complete, fully functional example of how to use the AsyncPinionAIClient. In the link to our examples, you can run a Streamlit, CLI chat, Slack or Teams. Note: you can run a targeted agent or deploy to accept AIA files to run various agents.
Configuration For Developers
Setting up the environment
To set up a development environment, first create and activate a virtual environment using uv:
# Create a virtual environment named .venv +uv venv
# Activate the virtual environment
# On macOS and Linux
source .venv/bin/activate
# On Windows
.venv\Scripts\activate
Then, install the package in editable mode with its development dependencies:
uv pip install -e .[dev]
1 maintainer
Metadata
1 maintainer
Release files for pinionai 0.4.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| pinionai-0.4.7.tar.gz | 90.3 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pinionai-0.4.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 180.1 kB
Release files / pinionai-0.4.7.tar.gz
| Download URL | pinionai-0.4.7.tar.gz |
|---|---|
| Size | 90.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
47438492df463bb0ce7883dbceaf6bb8f0a5bd71ef655c54a5a8e08cd4bb4a4b
|
|
BLAKE2b-256 checksum How to use checksums |
514ee707c1ad643a948f598d6541a835bcc0e54bd1a5b0f98fa82bf916d44d1f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.3
|
Release files / pinionai-0.4.7-py3-none-any.whl
| Download URL | pinionai-0.4.7-py3-none-any.whl |
|---|---|
| Size | 89.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e798456a7efb05150b392f1df3f14c6bed7ccaf1d74e738dbc5a180394bef510
|
|
BLAKE2b-256 checksum How to use checksums |
07532103539f278e3d4477d8f7bd68f9a9c9ffa639b85d806b190dafb5cceecd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.3
|
Security for pinionai 0.4.7
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
