Getting Started

00Prerequisites

• -A Mentiko account (you'll need an invite code — join the waitlist if you don't have one)
• -For self-hosting, start with the public GitHub repository.
• -API keys for at least one LLM provider: Claude (Anthropic), GPT-5.4 (OpenAI), Gemini (Google), or Ollama for local models
• -A modern browser (Chrome, Firefox, Safari, Edge)

01Create Your First Workspace

A workspace is an execution environment where your agents run. It defines where files live, how agents access the filesystem, and which tools are available. Think of it as a project directory with permissions.

1. 1.Navigate to Workspaces in the sidebar.
2. 2.Click New Workspace.
3. 3.Choose a workspace type:
   • -Local — recommended for getting started. Agents run on the same machine as your Mentiko instance.
   • -SSH — agents execute on a remote server via SSH.
   • -Docker — agents run inside isolated containers.
4. 4.Name your workspace, configure the working path, and hit save.

02Build Your First Chain

A chain is a pipeline of agents that coordinate through events. One agent finishes, emits an event, and the next agent picks it up. No polling. No orchestrator bottleneck. Just events.

1. 1.Navigate to Chains and click New Chain.
2. 2.The visual builder opens with a blank canvas.
3. 3.Drag a Researcher agent from the agent library onto the canvas.
4. 4.Drag a Summarizer agent next to it.
5. 5.Connect them: the Researcher emits research:complete, and the Summarizer triggers on that event.

Prefer code over drag-and-drop? Write the chain as JSON directly:

{
  "name": "my-first-chain",
  "agents": [
    {
      "name": "researcher",
      "prompt": "Research {TOPIC}.",
      "triggers": ["chain:start"],
      "emits": ["research:complete"]
    },
    {
      "name": "summarizer",
      "prompt": "Summarize the research.",
      "triggers": ["research:complete"],
      "emits": ["chain:complete"]
    }
  ]
}

Everything is JSON. Version control it. Diff it. Move it between instances.

03Run Your Chain

Time to see it work.

1. 1.Click Run in the chain builder toolbar.
2. 2.Enter your variables when prompted — for example, set TOPIC to "event-driven architecture".
3. 3.Watch the monitoring dashboard light up as each agent executes in real time.
4. 4.When the chain completes, open the run detail page to see full output, per-agent logs, and event traces.

04Schedule It

Chains that run once are demos. Chains that run on schedule are infrastructure. Set it and forget it.

1. 1.Go to Schedules and click New Schedule.
2. 2.Select the chain you just created.
3. 3.Set a cron expression. Some examples:

Your chain now runs automatically. Mentiko handles retries, timeout detection, and error routing. You get notified only when something needs a human.