Skip to main content

Python client for Converso AI API

Project description

๐Ÿค– Converso AI Python Library

A lightweight and powerful Python client for interacting with the Converso AI API.
Easily integrate AI models, generate images, retrieve tokens, chat with agents, and more โ€” all with just a few lines of code.


๐Ÿš€ Features

  • ๐Ÿ” Fetch available AI models (no API key required)
  • ๐Ÿ”‘ Retrieve API tokens (requires API key)
  • ๐Ÿ–ผ Generate images from text prompts (requires API key)
  • ๐Ÿ“‚ Access previously generated images (requires API key)
  • ๐Ÿ’ฌ Generate chat completions (requires API key)
  • ๐Ÿ‘ค Get responses from specific agents (requires API key)

๐Ÿ“ฆ Installation

Install directly from PyPI:

pip install converso-ai

โšก Quick Start

from converso_ai import ConversoAI

# Initialize client
client = ConversoAI(api_key="YOUR_API_KEY")

๐Ÿ’ป Usage Examples

๐Ÿ” Get Available Models

models = client.models()
print(models)

๐Ÿ”‘ Retrieve Tokens

tokens = client.tokens()
print(tokens)

๐Ÿ–ผ Generate an Image

image = client.generate_image(
    prompt="A futuristic cityscape",
    model="flux.1-dev"
)
print(image)

๐Ÿ’ฌ Generate Chat Completion

messages = [
    {"role": "user", "content": "Hello, who are you?"}
]
completion = client.chat_completion(
    model="gemini-2.5-flash",
    messages=messages
)
print(completion)

๐Ÿ‘ค Get Agent Response

response = client.agent_response(
    agent_id="AGENT_ID",
    prompt="What is the weather today?"
)
print(response)

๐Ÿ“‚ Project Structure

converso-ai/
โ”œโ”€โ”€ converso_ai/
โ”‚   โ””โ”€โ”€ __init__.py      # Core library code
โ”œโ”€โ”€ pyproject.toml       # Build & metadata
โ”œโ”€โ”€ requirements.txt     # Dependencies
โ”œโ”€โ”€ README.md            # Documentation
โ””โ”€โ”€ LICENSE              # License

๐Ÿ“– Documentation

Full API docs: Converso AI Docs


๐Ÿ“ License

This project is licensed under the MIT License. See the LICENSE file for details.


๐Ÿ”’ Privacy Policy

Read our Privacy Policy here: Privacy Policy


โญ Contributing

Contributions are welcome!

  • Fork the repo
  • Create a feature branch
  • Submit a pull request

Help us make Converso AI Python Library even better ๐Ÿš€


โšก Quick Links

Project details


Download files

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

Source Distribution

converso_ai-1.0.7.tar.gz (6.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

converso_ai-1.0.7-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

Details for the file converso_ai-1.0.7.tar.gz.

File metadata

  • Download URL: converso_ai-1.0.7.tar.gz
  • Upload date:
  • Size: 6.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.23

File hashes

Hashes for converso_ai-1.0.7.tar.gz
Algorithm Hash digest
SHA256 b4463d348da7148b637c6e6adf828e5289c4ce1f3800c2fc78a5ff94088b0268
MD5 fb53383bb92b48645045d630923f7f31
BLAKE2b-256 83c1a014d9e5cded78752edac4fcdf619bc9b0278d21ed25486bd9ff90426268

See more details on using hashes here.

File details

Details for the file converso_ai-1.0.7-py3-none-any.whl.

File metadata

  • Download URL: converso_ai-1.0.7-py3-none-any.whl
  • Upload date:
  • Size: 6.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.23

File hashes

Hashes for converso_ai-1.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 7fed92dd132ee4a30e8a28b22616fab55ebb86a63253c1460d07b6aebab49081
MD5 1087f16753c35bd142e19c13c214f932
BLAKE2b-256 8b303355c4fecddf132c8ea9c177d5f620f7188ed728b00ca29eb01a8b9bd970

See more details on using hashes here.

Supported by

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