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.6.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.6-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for converso_ai-1.0.6.tar.gz
Algorithm Hash digest
SHA256 3e5c2529b735a2ba75e474f8846907f77628fcb532e96372aff3afd873128236
MD5 a603ddb776a33fc2e1660277a6acb800
BLAKE2b-256 2600c8dc618857d6efe5405888794148a8578780ffdd82f6df42852c4a311b3a

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for converso_ai-1.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 8e29848dd8d923be4cf9d8d0b1ef88e4442275b1af309a810b551db22fb49089
MD5 2da27ae942cc371c11ff9260d5d51c1f
BLAKE2b-256 b36b6615309adc601ebb9feab8dd3537293806fcecaea864dfd3f98247ff1ab1

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