Magpie¶

Use the magpie provider to call a local Magpie gateway, which routes each request to the service behind the selected model. It supports chat and decisions. Chat requests default to Chat Completions; Responses and Messages are also available.

Get started¶

Install Republic using the quickstart, start Magpie, and replace MODEL_ID with a model from its catalog:

import asyncio

import republic


async def main():
    model = republic.get_model("magpie:MODEL_ID")
    response = await model.chat("Say hello in one sentence.")
    print(response.text)


asyncio.run(main())

Authentication¶

Magpie holds the upstream credentials, so Republic needs none. When REPUBLIC_MAGPIE_API_KEY or api_key= is set, it is sent in the Authorization: Bearer header.

Model support¶

The default endpoint is http://127.0.0.1:3425/v1. Select api_format="responses" or api_format="messages" to use another format, and get_decision_model() for decision models served through the gateway.

See configuration for endpoint overrides and request options.