Getting Started

Get Talovi running in your project in under 30 minutes. Choose your path below.

Path 1 — Small Business Owner

You want AI on your website but do not want to write code. Here is how to get started.

Step 1 — Try the live demo

Before anything else, try the live demo at talovi.dev/demo to see what Talovi can do for your business.

Step 2 — Choose your domain

Talovi has specialized agents for different business types:

  • Healthcare — Medical practices, pharmacies, clinics
  • Legal — Law firms, legal aid organizations
  • Real Estate — Agencies, property management, brokers
  • Retail — Shops, restaurants, hospitality
  • General — Any other small business

Step 3 — Get an API key

💳 Cost transparency

When you create an API key and use it with Talovi, you will be billed directly by your AI provider based on actual usage. Talovi never charges you or handles your payment information.

Typical costs: Light use ~$0.30/month · Moderate use ~$1.50/month · Heavy use ~$6.00/month

Free option: Use Ollama to run AI locally on your computer — completely free, no credit card required.

Talovi uses your own AI provider key — this keeps costs low and your data private. The easiest option for beginners is Claude by Anthropic:

  1. Go to console.anthropic.com
  2. Create a free account
  3. Go to API Keys and create a new key
  4. Copy the key — it starts with sk-ant-

Step 4 — Add Talovi to your website

Add this single line to your website before the closing body tag:

<script src="https://cdn.talovi.dev/embed.js"
  data-key="YOUR_API_KEY"
  data-domain="general">
</script>

Replace YOUR_API_KEY with your Anthropic key and general with your business domain.

Step 5 — Need help?

ITLasso offers implementation services for small businesses. Contact ITLasso to get Talovi set up on your website professionally.

Path 2 — Developer

You want to build with Talovi or deploy it for a client. Here is the full setup guide.

Step 1 — Prerequisites

  • Node.js 18 or later
  • An API key from your chosen provider (Anthropic, Google, xAI, or Ollama locally)
  • npm or yarn

Step 2 — Install Talovi

npm install talovi

Step 3 — Set up your environment

# Create a .env file
ANTHROPIC_API_KEY=sk-ant-your-key-here

# Or for Gemini
GEMINI_API_KEY=your-gemini-key

# Or for Grok
GROK_API_KEY=your-grok-key

Step 4 — Create your first agent

import { createAgent } from "talovi";

const agent = createAgent({
  provider: "claude",
  apiKey: process.env.ANTHROPIC_API_KEY,
  domain: "general",
  tier: "standard"
});

const response = await agent.chat(
  "How can I help my business grow?"
);

console.log(response);

Step 5 — Switch providers

Switching from Claude to Gemini takes one line:

const agent = createAgent({
  provider: "gemini", // changed from claude
  apiKey: process.env.GEMINI_API_KEY,
  domain: "general"
});

Step 6 — Use a domain agent

// Healthcare agent example
const agent = createAgent({
  provider: "claude",
  apiKey: process.env.ANTHROPIC_API_KEY,
  domain: "healthcare"
});

const response = await agent.chat(
  "What should I know about patient intake forms?"
);

Step 7 — Deploy

Talovi works anywhere Node.js runs — Vercel, Netlify, Railway, a VPS, or your own server. See the full documentation for deployment guides.

Need help?

Open an issue on GitHub or join the community discussion.

Read our launch announcement — Talovi Is Live →