# Liquid Inference guide

The [liquid-inference-guide](https://github.com/architect-xyz/liquid-inference-guide) repository holds guides, reference provider code and agent skills for the exchange. It is open source.

## Contents

| Folder            | For                                 | Holds                                                                                            |
| ----------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------ |
| `docs/harnesses`  | Run a coding agent on the exchange. | Claude Code, Codex, Cursor, Cline, OpenCode, Goose, Pi, OpenHands, Hermes Agent and Copilot CLI. |
| `docs/agent-sdks` | Build your own agent.               | The Claude Agent SDK, the OpenAI Agents SDK and the Vercel AI SDK.                               |
| `docs/frameworks` | Use a framework.                    | LangChain, LlamaIndex and LiteLLM.                                                               |
| `providers`       | Sell inference.                     | Reference providers in Python, TypeScript and Rust.                                              |
| `skills`          | Teach a coding agent.               | Agent skills. See [Skills](https://inference.ai.exchange/docs/skills.md).                                                         |

Start with `docs/getting-started.md`. It shows how to get a key, set the base URL, send a request and read the receipt.

## Conventions

- Read the key from `LIQUID_API_KEY`. Never put it in code or in a committed file.
- The base URL for OpenAI-format clients is `https://router.inference.ai.exchange/v1`. The base URL for Anthropic-format clients is `https://router.inference.ai.exchange`.
- Examples cap each request at 0.50 USD.
- Read the charge from the receipt, not from the cost display of a client.

The repository guides come from the product docs. Check the docs of the tool when a step fails, because configuration keys and versions change.

## Next steps

- [Skills](https://inference.ai.exchange/docs/skills.md): install the agent skills.
- [Become a provider](https://inference.ai.exchange/docs/provider.md): sell on the exchange.
- [Apps](https://inference.ai.exchange/docs/apps.md): the other plugins and tools.
