mechanix 0.1.0a5

The official Python library for the mechanix API

Mechanix Python API

The Mechanix Python library provides convenient access to the Mechanix REST API from any Python 3.8+ application. The library includes type definitions for all request params and response fields, and offers both synchronous and asynchronous clients.

Documentation

• General Documentation
• REST API Reference
• Python SDK API

Installation

pip install --pre mechanix

Usage

from mechanix import Mechanix

client = Mechanix()

search_response_bundle = client.tools.search.web(
    query="Common organelles within a human eukaryote",
)
print(search_response_bundle.llm)

While you can provide an api_key keyword argument, we recommend using python-dotenv to add MECHANIX_API_KEY="My API Key" to your .env file so that your API Key is not stored in source control.

Async usage

Simply import AsyncMechanix instead of Mechanix and use await with each API call:

import asyncio
from mechanix import AsyncMechanix

client = AsyncMechanix()


async def main() -> None:
    search_response_bundle = await client.tools.search.web(
        query="Common organelles within a human eukaryote",
    )
    print(search_response_bundle.llm)


asyncio.run(main())

Functionality between the synchronous and asynchronous clients is otherwise identical.

Handling errors

When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of mechanix.APIConnectionError is raised.

When the API returns a non-success status code (that is, 4xx or 5xx response), a subclass of mechanix.APIStatusError is raised, containing status_code and response properties.

All errors inherit from mechanix.APIError.

import mechanix
from mechanix import Mechanix

client = Mechanix()

try:
    client.tools.search.web(
        query="Common organelles within a human eukaryote",
    )
except mechanix.APIConnectionError as e:
    print("The server could not be reached")
    print(e.__cause__)  # an underlying Exception, likely raised within httpx.
except mechanix.RateLimitError as e:
    print("A 429 status code was received; we should back off a bit.")
except mechanix.APIStatusError as e:
    print("Another non-200-range status code was received")
    print(e.status_code)
    print(e.response)

Error codes are as followed:

Status Code	Error Type
400	BadRequestError
401	AuthenticationError
403	PermissionDeniedError
404	NotFoundError
422	UnprocessableEntityError
429	RateLimitError
>=500	InternalServerError
N/A	APIConnectionError

Credits

This API library is generated with Stainless.