Everything you need to integrate Tapas into your stack. Choose your language below for installation guides, typed interfaces, and working code examples.
New to Tapas? Begin here — step-by-step from install to production.
Install SDK
npm, pip, go get, or Cargo
Authenticate
API key or session cookie
First query
Cached response in <50ms
Fully typed client with TapasResponse interface, React hooks, streaming support, and error handling patterns.
npm install @tapas-ai/sdkTyped Go struct with JSON tags for TapasResponse. Drop into any Go HTTP service or middleware layer.
go get tapas.one/sdkSerde-annotated TapasResponse struct for Rust. Ideal for high-performance inference middleware and edge deployments.
tapas-sdk = "0.1"Typed dataclasses, synchronous TapasClient, async httpx support, LangChain wrapper, and batch query helpers.
pip install tapas-aiFull REST API reference — all endpoints, request/response schemas, error codes, rate limits, and cURL examples.
No install neededUse the OpenAI SDK client pointed at Tapas. Zero code changes needed if you already use the OpenAI SDK.
npm install openaiGet your first cached response in under 5 minutes.
Add Tapas as middleware to ChatGPT, Claude, Gemini, or any AI stack.
Understand how queries are classified and routed to the cache.
Browse all 160+ knowledge categories across 7 domains.
| Endpoint | Method | Description | Auth |
|---|---|---|---|
/api/trpc/query.ask | POST | Submit a query — returns cached or AI-generated answer with energy metrics | None |
/api/trpc/categories.list | GET | List all knowledge categories with domain counts | None |
/api/trpc/energy.summary | GET | Platform-wide energy savings summary and cache hit rate | None |
/api/trpc/energy.trend | GET | 30-day daily energy savings trend data | None |
/api/trpc/submissions.create | POST | Submit a community Q&A contribution for admin review | User |
/api/trpc/cache.list | GET | List all cached responses (admin) | Admin |
/api/trpc/cache.warm | POST | Trigger adaptive cache warming job (admin) | Admin |
/api/trpc/settings.list | GET | List all platform configuration settings (admin) | Admin |
Start with the Quick Start guide or jump straight into your language of choice above.