abov3-ai

ABOV3 Python SDK - Genesis CodeForger Edition

The official Python SDK for ABOV3 AI - Genesis CodeForger Edition.

Official Website: https://www.abov3.ai ABOV3 Team: https://www.abov3.com

Installation

pip install abov3-ai

Quick Start

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.9

Repository Migration

• Migrated from personal repository to official ABOV3AI organization
• Updated all documentation URLs to point to https://www.abov3.ai/docs
• Improved publishing workflow with GitHub Actions

Previous Updates (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

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

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

export ABOV3_API_KEY="your-api-key"
export ABOV3_BASE_URL="https://api.abov3.ai"  # Optional

Code Configuration

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

# 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

# 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

# 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

# Clone the repository
git clone https://github.com/ABOV3AI/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://www.abov3.ai/docs
• Website: https://www.abov3.ai
• GitHub: https://github.com/ABOV3AI/abov3-sdk-python
• Issues: GitHub Issues

License

MIT License - see LICENSE file for details.

About ABOV3

ABOV3 AI is an advanced code generation framework that revolutionizes how developers interact with AI. Visit abov3.ai to learn more.