aGochi
Documentation

Agochi Docs

Everything you need to create, style, and embed a living companion on any website.

Basics

What is Agochi?

Agochi is a tiny AI character — an NPC — that lives on a website. You give it a name, a role, and a look; it wakes up on your page, greets visitors, answers questions, and reacts to the conversation with emotions and little animations.

Companions run on Agochi's hosted brain, so there is no backend to run and no key to ship. One line of HTML puts a companion on any site.

Get going

Quickstart

  1. Create your companion — name, role, persona, look. Takes under a minute.
  2. Try it in the Studio — chat, tune the persona, watch it react.
  3. Copy the embed snippet from the Studio and paste it into any HTML page. Done.
One line

Embedding

The auto-inject form — this single line adds a floating companion to a page:

<script src="https://agochi.fun/embed.js" data-agent="YOUR_AGENT_ID" defer></script>

Or place the element yourself if you want control over where it mounts:

<script src="https://agochi.fun/embed.js"></script>
<agochi-agent agent-id="YOUR_AGENT_ID" position="bottom-right"></agochi-agent>

position accepts bottom-right or bottom-left. Your agent id is shown in the Studio and in the ready-to-paste snippet. See a live example on the embed demo.

For builders

Chat API

The widget is optional — you can drive a companion from anything that can POST. The persona always comes from Agochi's server, so replies stay in character no matter who calls.

POST https://agochi.fun/api/agents/{agentId}/chat
Content-Type: application/json

{
  "message": "what can you do?",
  "history": [
    { "role": "user", "content": "hi" },
    { "role": "assistant", "content": "Hey! How can I help?" }
  ]
}

The response is structured, so avatars and UI can react:

{
  "message": "I can guide visitors, answer questions, …",
  "emotion": "friendly",        // friendly | excited | focused | …
  "animation": "talk",         // idle | talk | wave | explain | …
  "events": [ … ],             // telemetry for dashboards
  "paidAction": null           // set only when a skill requires payment
}

Limits: 20 messages / minute / IP · message ≤ 4000 chars · history ≤ 20 turns

On chain

The AGOCHI token

The official contract address will be published here and on the Token Worlds page. Treat any other address as unofficial.

Good to know

FAQ

Does it work on any site? Yes — plain HTML, React, Vue, whatever. The widget is a framework-free web component with its own isolated styles.

Is it free? Creating, chatting, and embedding companions is free during the MVP preview.

What is it powered by? A hosted language model returns structured replies, which keeps the avatar's emotions and animations in sync with what it says.

Can I style the avatar? Pick from five living avatar styles at creation — each animates and reacts today.

Docs · Agochi