# ABOV3 Python SDK - Genesis CodeForger Edition
[](https://pypi.org/project/abov3-ai/)
[](https://pypi.org/project/abov3-ai/)
[](https://docs.abov3.ai)
The official Python SDK for **ABOV3 AI** - Genesis CodeForger Edition.
**Official Website:** [https://www.abov3.ai](https://www.abov3.ai)
**ABOV3 Team:** [https://www.abov3.com](https://www.abov3.com)
## Installation
```bash
pip install abov3-ai
```
## Quick Start
```python
from abov3 import Abov3Client
# Initialize the client
client = Abov3Client(
api_key="your-api-key",
base_url="https://api.abov3.ai" # Optional, defaults to production
)
# Create a session
session = await client.sessions.create(
model="claude-3-opus",
system_prompt="You are a helpful coding assistant"
)
# Send a message
response = await client.messages.create(
session_id=session.id,
content="Write a Python function to calculate fibonacci numbers"
)
print(response.content)
```
## What's New in v0.1.4
### TUI Configuration Management
The TUI now includes comprehensive configuration management commands:
- Interactive configuration dialogs with form inputs
- Provider management (add, edit, enable/disable, remove)
- MCP server configuration
- System health checks and validation
- Scrollable configuration viewer
### Features Update
- Real-time configuration updates
- Form-based input for adding providers and MCP servers
- Health diagnostics with `config doctor` command
- Configuration validation with detailed error reporting
## Features
- 🚀 **Full API Coverage** - Complete access to all ABOV3 AI capabilities
- 🔒 **Type Safety** - Full type hints and runtime validation with Pydantic
- ⚡ **Async Support** - Built on httpx for high-performance async operations
- 🔄 **Auto Retry** - Automatic retry with exponential backoff
- 📊 **Streaming** - Support for streaming responses
- 🔧 **Configuration API** - Manage ABOV3 configurations programmatically (v0.1.1+)
- 🧪 **Well Tested** - Comprehensive test coverage
## Streaming Responses
```python
async with client.messages.stream(
session_id=session.id,
content="Generate a long story"
) as stream:
async for chunk in stream:
print(chunk.content, end="")
```
## Error Handling
```python
from abov3.exceptions import Abov3Error, RateLimitError
try:
response = await client.messages.create(...)
except RateLimitError as e:
print(f"Rate limited: {e}")
# Wait and retry
except Abov3Error as e:
print(f"API error: {e}")
```
## Configuration
### Environment Variables
```bash
export ABOV3_API_KEY="your-api-key"
export ABOV3_BASE_URL="https://api.abov3.ai" # Optional
```
### Code Configuration
```python
client = Abov3Client(
api_key="your-api-key",
timeout=30.0, # Request timeout in seconds
max_retries=3, # Maximum retry attempts
proxy="http://proxy.example.com:8080" # Optional proxy
)
```
## Available Models
- `claude-3-opus` - Most capable model for complex tasks
- `claude-3-sonnet` - Balanced performance and speed
- `gpt-4-turbo` - OpenAI's most capable model
- `gpt-3.5-turbo` - Fast and cost-effective
## API Reference
### Sessions
```python
# Create a session
session = await client.sessions.create(model="claude-3-opus")
# Get session
session = await client.sessions.get(session_id)
# List sessions
sessions = await client.sessions.list(limit=10)
# Delete session
await client.sessions.delete(session_id)
```
### Messages
```python
# Send message
message = await client.messages.create(
session_id=session_id,
content="Your message here"
)
# Stream message
async with client.messages.stream(...) as stream:
async for chunk in stream:
process(chunk)
```
### Files
```python
# Upload file
file = await client.files.upload(
file_path="./document.pdf",
purpose="analysis"
)
# List files
files = await client.files.list()
# Delete file
await client.files.delete(file_id)
```
## Development
### Setup Development Environment
```bash
# Clone the repository
git clone https://github.com/fajardofahad/abov3-sdk-python.git
cd abov3-sdk-python
# Install development dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Format code
black src tests
ruff check src tests
# Type checking
mypy src
```
## Support
- **Documentation**: [https://docs.abov3.ai](https://docs.abov3.ai)
- **Website**: [https://www.abov3.ai](https://www.abov3.ai)
- **GitHub**: [https://github.com/fajardofahad/abov3-sdk-python](https://github.com/fajardofahad/abov3-sdk-python)
- **Issues**: [GitHub Issues](https://github.com/fajardofahad/abov3-sdk-python/issues)
## License
MIT License - see [LICENSE](LICENSE) file for details.
## About ABOV3
ABOV3 AI is an advanced code generation framework that revolutionizes how developers interact with AI. Visit [abov3.ai](https://www.abov3.ai) to learn more.
Raw data
{
"_id": null,
"home_page": null,
"name": "abov3-ai",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "abov3, ai, api, artificial-intelligence, code-generation, developer-tools, machine-learning, sdk",
"author": null,
"author_email": "ABOV3 Team <support@abov3.ai>",
"download_url": "https://files.pythonhosted.org/packages/83/c8/628cbf0a51661b6111f0ec2c445c2e9d16d63c8a51025ad1bb940072e7f0/abov3_ai-0.1.4.tar.gz",
"platform": null,
"description": "# ABOV3 Python SDK - Genesis CodeForger Edition\n\n[](https://pypi.org/project/abov3-ai/)\n[](https://pypi.org/project/abov3-ai/)\n[](https://docs.abov3.ai)\n\nThe official Python SDK for **ABOV3 AI** - Genesis CodeForger Edition.\n\n**Official Website:** [https://www.abov3.ai](https://www.abov3.ai)\n**ABOV3 Team:** [https://www.abov3.com](https://www.abov3.com)\n\n## Installation\n\n```bash\npip install abov3-ai\n```\n\n## Quick Start\n\n```python\nfrom abov3 import Abov3Client\n\n# Initialize the client\nclient = Abov3Client(\n api_key=\"your-api-key\",\n base_url=\"https://api.abov3.ai\" # Optional, defaults to production\n)\n\n# Create a session\nsession = await client.sessions.create(\n model=\"claude-3-opus\",\n system_prompt=\"You are a helpful coding assistant\"\n)\n\n# Send a message\nresponse = await client.messages.create(\n session_id=session.id,\n content=\"Write a Python function to calculate fibonacci numbers\"\n)\n\nprint(response.content)\n```\n\n## What's New in v0.1.4\n\n### TUI Configuration Management\nThe TUI now includes comprehensive configuration management commands:\n- Interactive configuration dialogs with form inputs\n- Provider management (add, edit, enable/disable, remove)\n- MCP server configuration\n- System health checks and validation\n- Scrollable configuration viewer\n\n### Features Update\n- Real-time configuration updates\n- Form-based input for adding providers and MCP servers\n- Health diagnostics with `config doctor` command\n- Configuration validation with detailed error reporting\n\n## Features\n\n- \ud83d\ude80 **Full API Coverage** - Complete access to all ABOV3 AI capabilities\n- \ud83d\udd12 **Type Safety** - Full type hints and runtime validation with Pydantic\n- \u26a1 **Async Support** - Built on httpx for high-performance async operations\n- \ud83d\udd04 **Auto Retry** - Automatic retry with exponential backoff\n- \ud83d\udcca **Streaming** - Support for streaming responses\n- \ud83d\udd27 **Configuration API** - Manage ABOV3 configurations programmatically (v0.1.1+)\n- \ud83e\uddea **Well Tested** - Comprehensive test coverage\n\n## Streaming Responses\n\n```python\nasync with client.messages.stream(\n session_id=session.id,\n content=\"Generate a long story\"\n) as stream:\n async for chunk in stream:\n print(chunk.content, end=\"\")\n```\n\n## Error Handling\n\n```python\nfrom abov3.exceptions import Abov3Error, RateLimitError\n\ntry:\n response = await client.messages.create(...)\nexcept RateLimitError as e:\n print(f\"Rate limited: {e}\")\n # Wait and retry\nexcept Abov3Error as e:\n print(f\"API error: {e}\")\n```\n\n## Configuration\n\n### Environment Variables\n\n```bash\nexport ABOV3_API_KEY=\"your-api-key\"\nexport ABOV3_BASE_URL=\"https://api.abov3.ai\" # Optional\n```\n\n### Code Configuration\n\n```python\nclient = Abov3Client(\n api_key=\"your-api-key\",\n timeout=30.0, # Request timeout in seconds\n max_retries=3, # Maximum retry attempts\n proxy=\"http://proxy.example.com:8080\" # Optional proxy\n)\n```\n\n## Available Models\n\n- `claude-3-opus` - Most capable model for complex tasks\n- `claude-3-sonnet` - Balanced performance and speed\n- `gpt-4-turbo` - OpenAI's most capable model\n- `gpt-3.5-turbo` - Fast and cost-effective\n\n## API Reference\n\n### Sessions\n\n```python\n# Create a session\nsession = await client.sessions.create(model=\"claude-3-opus\")\n\n# Get session\nsession = await client.sessions.get(session_id)\n\n# List sessions\nsessions = await client.sessions.list(limit=10)\n\n# Delete session\nawait client.sessions.delete(session_id)\n```\n\n### Messages\n\n```python\n# Send message\nmessage = await client.messages.create(\n session_id=session_id,\n content=\"Your message here\"\n)\n\n# Stream message\nasync with client.messages.stream(...) as stream:\n async for chunk in stream:\n process(chunk)\n```\n\n### Files\n\n```python\n# Upload file\nfile = await client.files.upload(\n file_path=\"./document.pdf\",\n purpose=\"analysis\"\n)\n\n# List files\nfiles = await client.files.list()\n\n# Delete file\nawait client.files.delete(file_id)\n```\n\n## Development\n\n### Setup Development Environment\n\n```bash\n# Clone the repository\ngit clone https://github.com/fajardofahad/abov3-sdk-python.git\ncd abov3-sdk-python\n\n# Install development dependencies\npip install -e \".[dev]\"\n\n# Run tests\npytest\n\n# Format code\nblack src tests\nruff check src tests\n\n# Type checking\nmypy src\n```\n\n## Support\n\n- **Documentation**: [https://docs.abov3.ai](https://docs.abov3.ai)\n- **Website**: [https://www.abov3.ai](https://www.abov3.ai)\n- **GitHub**: [https://github.com/fajardofahad/abov3-sdk-python](https://github.com/fajardofahad/abov3-sdk-python)\n- **Issues**: [GitHub Issues](https://github.com/fajardofahad/abov3-sdk-python/issues)\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## About ABOV3\n\nABOV3 AI is an advanced code generation framework that revolutionizes how developers interact with AI. Visit [abov3.ai](https://www.abov3.ai) to learn more.",
"bugtrack_url": null,
"license": "MIT",
"summary": "Official Python SDK for ABOV3 AI - Genesis CodeForger Edition",
"version": "0.1.4",
"project_urls": {
"Documentation": "https://docs.abov3.ai",
"Homepage": "https://www.abov3.ai",
"Issues": "https://github.com/fajardofahad/abov3-sdk-python/issues",
"Repository": "https://github.com/fajardofahad/abov3-sdk-python"
},
"split_keywords": [
"abov3",
" ai",
" api",
" artificial-intelligence",
" code-generation",
" developer-tools",
" machine-learning",
" sdk"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "4421ab28856b13131ef80edc558a46f62ff29dae3633d080147a90e3d64389b9",
"md5": "c61ccaf0c59a7febb97f0339428d17c5",
"sha256": "5d864b5890fac8a77ac344d389816b7d073f6ced6958799da25fb1435cb835b8"
},
"downloads": -1,
"filename": "abov3_ai-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c61ccaf0c59a7febb97f0339428d17c5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 8718,
"upload_time": "2025-09-20T01:36:07",
"upload_time_iso_8601": "2025-09-20T01:36:07.068455Z",
"url": "https://files.pythonhosted.org/packages/44/21/ab28856b13131ef80edc558a46f62ff29dae3633d080147a90e3d64389b9/abov3_ai-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "83c8628cbf0a51661b6111f0ec2c445c2e9d16d63c8a51025ad1bb940072e7f0",
"md5": "6ff156afaaccb6f1ca3956a72d77ab2e",
"sha256": "93cba6c6ada8880db7361b894def40084fbf07c4b95b0e5fac20833c99978318"
},
"downloads": -1,
"filename": "abov3_ai-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "6ff156afaaccb6f1ca3956a72d77ab2e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 7656,
"upload_time": "2025-09-20T01:36:08",
"upload_time_iso_8601": "2025-09-20T01:36:08.092144Z",
"url": "https://files.pythonhosted.org/packages/83/c8/628cbf0a51661b6111f0ec2c445c2e9d16d63c8a51025ad1bb940072e7f0/abov3_ai-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-20 01:36:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "fajardofahad",
"github_project": "abov3-sdk-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "abov3-ai"
}
JSON
