Tera

AI capabilities API — chat completions, writing (rewrite / draft), and coding (explain / review / write).

Part of Talocode. Hosted at /v1/tera/* on the Talocode Cloud base URL.

Why Tera?

Builders need a small set of high-value AI actions with clear credit prices—not a raw model reseller dump.

Open clients; hosted inference is metered on Talocode Cloud.

Install

pip install -U talocode-tera

Python 3.10+, stdlib only.

Quickstart

import os
from tera import TeraClient

client = TeraClient(api_key=os.environ["TALOCODE_API_KEY"])
# TALOCODE_BASE_URL defaults to https://api.talocode.site

# Health / pricing / capabilities
print(client.health())
print(client.pricing())
print(client.capabilities())

# Chat
chat = client.chat_completions(
    messages=[{"role": "user", "content": "What is Talocode?"}],
    model=None,  # host default
    max_tokens=512,
    temperature=0.3,
)

# Writing
rewritten = client.writing_rewrite(
    "hey team ship is delayed",
    style="professional",
    tone="neutral",
)
draft = client.writing_draft(
    type="email",
    brief="Announce SearchLane launch to early users",
    audience="developers",
)

# Coding
explain = client.coding_explain("python", "print('hello')", level="beginner")
review = client.coding_review("typescript", "const x: any = 1;", focus=["types", "bugs"])
write = client.coding_write(
    "python",
    task="Parse ISO dates safely",
    style="production-ready",
    generate_tests=True,
)

Environment

HTTP routes

Auth: Authorization: Bearer $TALOCODE_API_KEY.

CLI

export TALOCODE_API_KEY=...

tera health
tera capabilities
tera chat --message "What is Python?"
tera rewrite --text "Hello world"
tera draft --type email --brief "Follow up with a customer"
tera explain --language python --code "print('hello')"
tera review --language typescript --code "const x = 1"

Client API

from tera import TeraClient, TeraError, create_tera_client

client = TeraClient(api_key=None, base_url=None)
client.health()
client.pricing()
client.capabilities()
client.chat_completions(messages, model=None, max_tokens=None, temperature=None)
client.writing_rewrite(text, style="professional", tone="neutral", max_length=None)
client.writing_draft(type, brief, audience="general", tone="neutral", max_length=None)
client.coding_explain(language, code, level="intermediate", focus=None)
client.coding_review(language, code, focus=None, strictness="normal")
client.coding_write(language, task, context=None, style="production-ready", generate_tests=False)

TeraError is raised on API failures.

Related packages

Talocode ecosystem

More: github.com/talocode · talocode.site · docs.talocode.site

License

MIT © Talocode