keirolabs 0.1.1

Official Python SDK for KeiroLabs API - Search, Research, and Web Crawling

KeiroLabs Python SDK

Official Python SDK for the KeiroLabs API - providing easy access to search, research, and web crawling capabilities.

🚀 Installation

pip install keirolabs

📖 Quick Start

from keirolabs import Keiro

# Initialize the client
client = Keiro(api_key="your-api-key-here")

# Perform a basic search (costs 1 credit)
result = client.search("What is machine learning?")
print(result['data'])
print(f"Credits remaining: {result['creditsRemaining']}")

# Get a detailed answer (costs 5 credits)
answer = client.answer("Explain quantum computing in simple terms")
print(answer['data'])

# Perform research
research = client.research("Latest developments in AI")
print(research)

🔧 Configuration

Production Server (Default)

The SDK automatically uses the production server - no configuration needed!

from keirolabs import Keiro

# That's it! Production server is automatic
client = Keiro(api_key="your-api-key")

Local Development (Optional)

Only specify base_url if you're running a local development server:

# For local development only
client = Keiro(
    api_key="your-api-key",
    base_url="http://localhost:8000/api"
)

Environment Variables (Recommended)

import os
from keirolabs import Keiro

# Production (base_url is automatic)
client = Keiro(api_key=os.getenv("KEIRO_API_KEY"))

# Or for local development
client = Keiro(
    api_key=os.getenv("KEIRO_API_KEY"),
    base_url="http://localhost:8000/api"  # Only for local dev
)

Create a .env file:

KEIRO_API_KEY=your-api-key-here
# KEIRO_BASE_URL only needed for local development

Load it using python-dotenv:

pip install python-dotenv

from dotenv import load_dotenv
import os
from keirolabs import Keiro

load_dotenv()
client = Keiro(api_key=os.getenv("KEIRO_API_KEY"))

📚 API Reference

Search APIs

search(query, **kwargs)

Perform basic search operation.

• Cost: 1 credit
• Args:
  • query (str): Search query
  • **kwargs: Additional parameters
• Returns: Dict with search results and credits remaining

result = client.search("Python programming tutorials")

search_pro(query, **kwargs)

Advanced search with Pro features.

result = client.search_pro("Advanced Python concepts")

search_engine(query, **kwargs)

Use the search engine functionality.

result = client.search_engine("Best Python libraries 2024")

Answer API

answer(query, **kwargs)

Generate detailed answers to questions.

• Cost: 5 credits
• Args:
  • query (str): Question to answer
  • **kwargs: Additional parameters
• Returns: Dict with answer and credits remaining

answer = client.answer("How does blockchain work?")

Research APIs

research(query, **kwargs)

Perform research on a topic.

research = client.research("Climate change solutions")

research_pro(query, **kwargs)

Advanced research with Pro features.

research = client.research_pro("Advanced AI research papers")

Web Crawler API

web_crawler(url, **kwargs)

Crawl and extract data from websites.

data = client.web_crawler("https://example.com")

Utility Methods

health_check()

Check API health status.

health = client.health_check()
print(health)

set_base_url(base_url)

Update the base URL.

client.set_base_url("https://api.keiro.com/api")

🛡️ Error Handling

The SDK provides specific exception classes for different error scenarios:

from keirolabs import Keiro
from keirolabs.exceptions import (
    KeiroAuthError,
    KeiroRateLimitError,
    KeiroValidationError,
    KeiroConnectionError,
    KeiroAPIError,
)

client = Keiro(api_key="your-api-key")

try:
    result = client.search("test query")
except KeiroAuthError:
    print("Invalid API key")
except KeiroRateLimitError:
    print("Out of credits")
except KeiroValidationError as e:
    print(f"Validation error: {e}")
except KeiroConnectionError as e:
    print(f"Connection failed: {e}")
except KeiroAPIError as e:
    print(f"API error: {e}")

Exception Types

• KeiroError: Base exception for all SDK errors
• KeiroAuthError: Invalid API key or authentication failure
• KeiroRateLimitError: Out of credits or rate limit exceeded
• KeiroValidationError: Invalid request parameters
• KeiroConnectionError: Network or connection issues
• KeiroAPIError: General API errors

🔐 Context Manager

Use the SDK with context manager for automatic cleanup:

with Keiro(api_key="your-api-key") as client:
    result = client.search("query")
    print(result)
# Session automatically closed

⚙️ Advanced Usage

Custom Timeout

client = Keiro(
    api_key="your-api-key",
    timeout=60  # 60 seconds timeout
)

Passing Additional Parameters

# All methods accept **kwargs for additional parameters
result = client.search(
    query="Python",
    custom_param="value",
    another_param=123
)

📝 Examples

Example 1: Basic Search and Answer

from keirolabs import Keiro

client = Keiro(api_key="your-api-key")

# Search for information
search_result = client.search("Best practices for Python")
print("Search Results:", search_result['data'])

# Get detailed answer
answer = client.answer("What are Python decorators?")
print("Answer:", answer['data'])
print(f"Credits Used: {answer['creditsRemaining']}")

Example 2: Web Crawling

from keirolabs import Keiro

client = Keiro(api_key="your-api-key")

# Crawl a website
crawl_data = client.web_crawler("https://example.com")
print("Crawled Data:", crawl_data)

Example 3: Error Handling

from keirolabs import Keiro
from keirolabs.exceptions import KeiroRateLimitError, KeiroAuthError

client = Keiro(api_key="your-api-key")

try:
    results = []
    queries = ["query1", "query2", "query3"]
    
    for query in queries:
        result = client.search(query)
        results.append(result)
        
except KeiroRateLimitError:
    print("Ran out of credits! Please add more credits to continue.")
except KeiroAuthError:
    print("Authentication failed. Check your API key.")

🧪 Testing

Create a test file to verify your setup:

# test_keiro.py
from keirolabs import Keiro
import os

def test_sdk():
    # Uses production server by default
    client = Keiro(api_key=os.getenv("KEIRO_API_KEY"))
    
    # Test health check
    health = client.health_check()
    print("✓ Health check passed:", health)
    
    # Test search
    result = client.search("test query")
    print("✓ Search passed:", result)
    
    print("\n✅ All tests passed!")

if __name__ == "__main__":
    test_sdk()

📦 Requirements

• Python >= 3.7
• requests >= 2.28.0

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

• Homepage: https://keiro.com
• Documentation: https://docs.keiro.com
• GitHub: https://github.com/yourusername/keiro-python-sdk
• PyPI: https://pypi.org/project/keirolabs/

💬 Support

For support, email [e-mail] or open an issue on GitHub.

📋 Changelog

Version 0.1.0 (Initial Release)

• ✅ Basic search functionality
• ✅ Answer generation
• ✅ Research capabilities
• ✅ Web crawler
• ✅ Comprehensive error handling
• ✅ Environment-aware base URL configuration
• ✅ Context manager support

---

Made with ❤️ by the KeiroLabs Team