| Name | converso-ai JSON |
| Version |
1.0.7
JSON |
| download |
| home_page | None |
| Summary | Python client for Converso AI API |
| upload_time | 2025-09-06 12:51:59 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.7 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
requests
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# 🤖 Converso AI Python Library
A lightweight and powerful **Python client** for interacting with the [Converso AI API](https://ai.conversoempire.world/).
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](https://pypi.org/project/converso-ai/):
```bash
pip install converso-ai
```
---
## ⚡ Quick Start
```python
from converso_ai import ConversoAI
# Initialize client
client = ConversoAI(api_key="YOUR_API_KEY")
```
---
## 💻 Usage Examples
### 🔍 Get Available Models
```python
models = client.models()
print(models)
```
### 🔑 Retrieve Tokens
```python
tokens = client.tokens()
print(tokens)
```
### 🖼 Generate an Image
```python
image = client.generate_image(
prompt="A futuristic cityscape",
model="flux.1-dev"
)
print(image)
```
### 💬 Generate Chat Completion
```python
messages = [
{"role": "user", "content": "Hello, who are you?"}
]
completion = client.chat_completion(
model="gemini-2.5-flash",
messages=messages
)
print(completion)
```
### 👤 Get Agent Response
```python
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](https://ai.conversoempire.world/)
---
## 📝 License
This project is licensed under the **MIT License**.
See the [LICENSE](./LICENSE) file for details.
---
## 🔒 Privacy Policy
Read our Privacy Policy here: [Privacy Policy](https://ai.conversoempire.world/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
* 📦 PyPI: [Converso AI](https://pypi.org/project/converso-ai/)
* 📚 Docs: [API Documentation](https://ai.conversoempire.world/)
* 🛠 Source: [GitHub Repository](https://github.com/muhammadgohar-official/converso-ai-python-library)
Raw data
{
"_id": null,
"home_page": null,
"name": "converso-ai",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Muhammad Gohar <mg03164525711@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/83/c1/a014d9e5cded78752edac4fcdf619bc9b0278d21ed25486bd9ff90426268/converso_ai-1.0.7.tar.gz",
"platform": null,
"description": "# \ud83e\udd16 Converso AI Python Library\n\nA lightweight and powerful **Python client** for interacting with the [Converso AI API](https://ai.conversoempire.world/). \nEasily integrate AI models, generate images, retrieve tokens, chat with agents, and more \u2014 all with just a few lines of code. \n\n---\n\n## \ud83d\ude80 Features\n- \ud83d\udd0d Fetch available AI models *(no API key required)*\n- \ud83d\udd11 Retrieve API tokens *(requires API key)*\n- \ud83d\uddbc Generate images from text prompts *(requires API key)*\n- \ud83d\udcc2 Access previously generated images *(requires API key)*\n- \ud83d\udcac Generate chat completions *(requires API key)*\n- \ud83d\udc64 Get responses from specific agents *(requires API key)*\n\n---\n\n## \ud83d\udce6 Installation\n\nInstall directly from [PyPI](https://pypi.org/project/converso-ai/):\n\n```bash\npip install converso-ai\n```\n\n---\n\n## \u26a1 Quick Start\n\n```python\nfrom converso_ai import ConversoAI\n\n# Initialize client\nclient = ConversoAI(api_key=\"YOUR_API_KEY\")\n```\n\n---\n\n## \ud83d\udcbb Usage Examples\n\n### \ud83d\udd0d Get Available Models\n\n```python\nmodels = client.models()\nprint(models)\n```\n\n### \ud83d\udd11 Retrieve Tokens\n\n```python\ntokens = client.tokens()\nprint(tokens)\n```\n\n### \ud83d\uddbc Generate an Image\n\n```python\nimage = client.generate_image(\n prompt=\"A futuristic cityscape\",\n model=\"flux.1-dev\"\n)\nprint(image)\n```\n\n### \ud83d\udcac Generate Chat Completion\n\n```python\nmessages = [\n {\"role\": \"user\", \"content\": \"Hello, who are you?\"}\n]\ncompletion = client.chat_completion(\n model=\"gemini-2.5-flash\",\n messages=messages\n)\nprint(completion)\n```\n\n### \ud83d\udc64 Get Agent Response\n\n```python\nresponse = client.agent_response(\n agent_id=\"AGENT_ID\",\n prompt=\"What is the weather today?\"\n)\nprint(response)\n```\n\n---\n\n## \ud83d\udcc2 Project Structure\n\n```\nconverso-ai/\n\u251c\u2500\u2500 converso_ai/\n\u2502 \u2514\u2500\u2500 __init__.py # Core library code\n\u251c\u2500\u2500 pyproject.toml # Build & metadata\n\u251c\u2500\u2500 requirements.txt # Dependencies\n\u251c\u2500\u2500 README.md # Documentation\n\u2514\u2500\u2500 LICENSE # License\n```\n\n---\n\n## \ud83d\udcd6 Documentation\n\nFull API docs: [Converso AI Docs](https://ai.conversoempire.world/)\n\n---\n\n## \ud83d\udcdd License\n\nThis project is licensed under the **MIT License**.\nSee the [LICENSE](./LICENSE) file for details.\n\n---\n\n## \ud83d\udd12 Privacy Policy\n\nRead our Privacy Policy here: [Privacy Policy](https://ai.conversoempire.world/privacy-policy)\n\n---\n\n## \u2b50 Contributing\n\nContributions are welcome!\n\n* Fork the repo\n* Create a feature branch\n* Submit a pull request\n\nHelp us make **Converso AI Python Library** even better \ud83d\ude80\n\n---\n\n## \u26a1 Quick Links\n\n* \ud83d\udce6 PyPI: [Converso AI](https://pypi.org/project/converso-ai/)\n* \ud83d\udcda Docs: [API Documentation](https://ai.conversoempire.world/)\n* \ud83d\udee0 Source: [GitHub Repository](https://github.com/muhammadgohar-official/converso-ai-python-library)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python client for Converso AI API",
"version": "1.0.7",
"project_urls": {
"Converso-AI_Telegarm-Channel": "https://t.me/conversoai",
"Converso-AI_Telegarm-Group": "https://t.me/conversoai_chat",
"Converso_AI-API_Docs": "https://conversoai.stylefort.store",
"Repository": "https://github.com/muhammadgohar-official/converso-ai-python-library"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8b303355c4fecddf132c8ea9c177d5f620f7188ed728b00ca29eb01a8b9bd970",
"md5": "1087f16753c35bd142e19c13c214f932",
"sha256": "7fed92dd132ee4a30e8a28b22616fab55ebb86a63253c1460d07b6aebab49081"
},
"downloads": -1,
"filename": "converso_ai-1.0.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1087f16753c35bd142e19c13c214f932",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 6053,
"upload_time": "2025-09-06T12:51:58",
"upload_time_iso_8601": "2025-09-06T12:51:58.446881Z",
"url": "https://files.pythonhosted.org/packages/8b/30/3355c4fecddf132c8ea9c177d5f620f7188ed728b00ca29eb01a8b9bd970/converso_ai-1.0.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "83c1a014d9e5cded78752edac4fcdf619bc9b0278d21ed25486bd9ff90426268",
"md5": "fb53383bb92b48645045d630923f7f31",
"sha256": "b4463d348da7148b637c6e6adf828e5289c4ce1f3800c2fc78a5ff94088b0268"
},
"downloads": -1,
"filename": "converso_ai-1.0.7.tar.gz",
"has_sig": false,
"md5_digest": "fb53383bb92b48645045d630923f7f31",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 6029,
"upload_time": "2025-09-06T12:51:59",
"upload_time_iso_8601": "2025-09-06T12:51:59.639333Z",
"url": "https://files.pythonhosted.org/packages/83/c1/a014d9e5cded78752edac4fcdf619bc9b0278d21ed25486bd9ff90426268/converso_ai-1.0.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-06 12:51:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "muhammadgohar-official",
"github_project": "converso-ai-python-library",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "requests",
"specs": [
[
">=",
"2.20.0"
]
]
}
],
"lcname": "converso-ai"
}
