Examples

Small programs live in examples/. None of them print a transcript or a reply unless the gateway returned it. If NATLAS_BASE_URL or NATLAS_API_KEY is missing, they say No N-ATLAS backend connected (or the shorter form the one-file scripts use) and exit. Unit tests inject a fake client. That fake never runs in the app.

Set the same variables as the quickstart. A trailing /v1 on the base URL is optional.

Voice-note translator

examples/voice-note-translator

A WhatsApp-style flow: an audio file in Hausa, Igbo, Yorùbá, or Nigerian English is transcribed with the matching NCAIR1 ASR model, then N-ATLaS either translates the transcript or replies to it.

npm install n-atlas
# or: pnpm add n-atlas

export NATLAS_BASE_URL=https://kambah123--natlas-serve-natlasservice-serve.modal.run
export NATLAS_API_KEY=your-gateway-key

node examples/voice-note-translator/cli.mjs voice-note.ogg --language ha --to en
node examples/voice-note-translator/cli.mjs voice-note.ogg --language ha --reply

node examples/voice-note-translator/server.mjs
# open http://127.0.0.1:8787

The web page is a local form (file, source language, translate or reply). The browser talks only to 127.0.0.1. The API key stays in the server process. The page shows the attribution string from the model terms. If the gateway is not configured, the page says so and the server does not open a connection.

Details and the test command are in that directory's README.

Support-reply helper

examples/support-reply

A customer-support draft. You pass the customer's message. The script asks N-ATLaS which of the four languages it is in, unless you pass --language, then asks N-ATLaS for a short reply in that language. The system prompt tells the model not to invent order numbers, refunds, or delivery dates. The words that come back are still the model's.

pip install natlas
python examples/support-reply/reply.py --message "My transfer has not arrived" --language en

One-file scripts

After npm install n-atlas (or pnpm add n-atlas) and pip install natlas:

node examples/js/chat.mjs
node examples/js/stream.mjs
node examples/js/transcribe.mjs path/to/note.ogg ha

python examples/python/chat.py
python examples/python/stream.py
python examples/python/transcribe.py path/to/note.ogg ha

transcribe defaults the language to Hausa when you omit it.

Playground

apps/playground is the live browser UI (chat, speech, and get-code) at https://natlas-playground.vercel.app. Use the examples above when you want something you can run from a terminal in a few minutes.