auto-genesis-sdk 0.0.3

A unified Python SDK for seamless integration with Autonomize services, providing telemetry, logging, and tracing capabilities.

Auto Genesis SDK

The Auto Genesis SDK serves as the unified interface for all Autonomize service SDKs. It provides a streamlined way to access and utilize various Autonomize capabilities through a single, cohesive package. This centralized approach simplifies dependency management and ensures version compatibility across all Autonomize SDKs.

Features

The Auto Genesis SDK provides several key advantages:

• Unified Access: Single entry point for all Autonomize SDKs
• Version Compatibility: Guaranteed compatibility between different SDK modules
• Simplified Dependencies: Managed dependencies and requirements across all SDKs
• Consistent Interface: Standardized API patterns across all SDK modules
• Integrated Configuration: Unified configuration management for all services

Available SDKs

Currently, the Auto Genesis SDK includes the following modules:

Telemetry SDK

Comprehensive observability solution built on OpenTelemetry, providing:

• Unified metrics, logging, and tracing capabilities
• FastAPI auto-instrumentation
• Configurable export endpoints
• Structured logging with context
• Custom metric creation and management

Installation

You can install the Auto Genesis SDK using pip:

pip install auto-genesis-sdk

Or using Poetry:

poetry add auto-genesis-sdk

Quick Start

Here's how to get started with the Auto Genesis SDK:

from auto_genesis_sdk import Telemetry, TelemetryConfig

# Configure telemetry service
config = TelemetryConfig(
    service_name="my-service",
    environment="production",
    otlp_endpoint="http://localhost:4317",
    version="1.0.0"
)

# Initialize telemetry
telemetry = Telemetry(config)
await telemetry.start()

try:
    # Use telemetry features
    telemetry.logging.info("Application started", {"version": "1.0.0"})

    # Create metrics
    request_counter = telemetry.metrics.create_counter(
        name="http.requests",
        description="Number of HTTP requests"
    )

    # Use tracing
    async def my_operation():
        return "result"

    result = await telemetry.tracing.create_span(
        "my-operation",
        my_operation
    )
finally:
    await telemetry.shutdown()

Configuration

Each SDK module maintains its own configuration options while sharing common patterns. For example, the Telemetry SDK configuration:

TelemetryConfig(
    service_name="my-service",
    environment="production",
    version="1.0.0",
    otlp_endpoint="http://localhost:4317",
    metric_interval_ms=5000,
    log_level="INFO"
)

Development

To set up the development environment:

1. Clone the repository:

git clone https://github.com/autonomize-ai/auto-genesis-sdk.git

2. Install dependencies with uv:

uv venv
uv pip install -e .

3. Install pre-commit hooks:

uv pip install pre-commit
pre-commit install

Testing

Run the test suite using pytest:

uv pip install pytest
pytest

Contributing

We welcome contributions to the Auto Genesis SDK! Please read our Contributing Guide before making any changes.

When contributing, keep in mind:

• Follow the existing code style and documentation patterns
• Add tests for new features
• Update documentation as needed
• Maintain compatibility with existing SDK modules

License

This project is licensed under the terms of the LICENSE.