Skip to Content
Getting StartedQuick Start

Quick Start

This guide walks through creating an agent and running a conversation after Nexora is installed.

Log in

Navigate to your Nexora instance (http://your-host) and create your admin account or sign in.

Nexora login screen

On a fresh install, you will land on a First-time setup screen to create the owner account and workspace.

Reach the workspace

After login you land in the chat workspace. The sidebar shows your organization and chats.

Nexora workspace

Add an LLM provider

Go to Settings → Accounts and click Add Account.

Settings Accounts tab — empty state

Use API-key providers for full agentic functionality.

OAuth providers (Claude, Gemini, Codex) authenticate through their respective CLI tools and run the model inside that CLI process. Nexora cannot orchestrate sub-agents, stream tool calls, or build provider chains with OAuth accounts. Full agentic control requires a direct API key.

Recommended providers (API key):

Nexora ships with ~25 API providers plus CLI/OAuth providers for Claude, Gemini, and Codex. The core provider chain is Claude → Gemini → OpenAI → Ollama with automatic fallback; the providers below are common starting points.

ProviderKey formatWhere to get it
Anthropic (Claude)sk-ant-...console.anthropic.com 
Google Gemini(API key)aistudio.google.com 
OpenAIsk-...platform.openai.com 
Ollama(none)Self-hosted, no key needed
DeepSeeksk-...platform.deepseek.com 
Groqgsk_...console.groq.com 
OpenCode (Zen / Go)sk-oc-...opencode.ai  — one key for frontier + budget models

Select the provider, paste your API key, and click Add Account.

Add Account modal — Claude OAuth flow (provider dropdown shown)

You can add multiple accounts per provider — Nexora chains them automatically for rate-limit fallback.

Create an agent

Go to Agents → New Agent. The wizard walks you through four steps.

Step 1 — Choose a persona to pre-configure capabilities and personality:

Agent wizard — persona selection step showing template cards

Step 2 — Identity — set a name, personality traits, and system prompt (pre-filled from the persona).

Step 3 — Capabilities — select tools (GitHub, GitLab, Bash, Git, Telegram…) and skills.

Step 4 — Environment — optionally configure environment variables the agent can access.

Click Create to save.

Start a conversation

Open New Chat from the workspace, select your agent, and start messaging.

The agent streams responses in real time via WebSocket. Tool calls appear inline as the agent executes them. Sub-agents run in parallel when the agent spawns them.

Provider types explained

Nexora calls the provider API directly. Full capabilities:

  • Sub-agent spawning and coordination
  • Provider chains with automatic fallback
  • Token usage tracking
  • Streaming tool calls visible in the UI

OAuth / CLI providers

Claude, Gemini, and Codex authenticate through their respective CLI tools installed in the Docker container. The model runs inside the CLI process — Nexora orchestrates the CLI as a subprocess. Sub-agent coordination and provider chaining are not available with these accounts. Use them for simple single-agent workflows when you prefer OAuth over managing API keys.

Agent capabilities

Tools

Tools give agents access to external systems:

ToolWhat it does
githubRead/write repos, issues, PRs via GitHub App
gitlabGitLab read/write via OAuth
bashExecute shell commands in a sandboxed environment
gitRun git commands: clone, commit, push, diff, log
telegramSend messages via Telegram bot
emailSend emails via SMTP
mcpConnect to any MCP server
schedulerSchedule recurring tasks

Sub-agents

An agent can delegate tasks to other agents. Sub-agents run in parallel (Redis-coordinated) and results are aggregated before returning to the parent.

Parent Agent
├── Sub-agent A (research)
├── Sub-agent B (write code)
└── Sub-agent C (review PR)
        ↓ results merged
Parent Agent continues

Concurrency limits:

  • MAX_CONCURRENT_AGENTS=2 per worker
  • MAX_CONCURRENT_AGENTS_PER_ORG=4 across all workers
  • TASKS_PER_BATCH=2 tasks dispatched per batch

Skills

Skills inject specialized instructions into the agent’s system prompt. Built-in skills include code review, search, summarization, and more. Custom skills can be added in seeds/skills/custom/.

All agent, tool, and skill definitions are file-based (seeds/ directory). No code changes needed to add new agents — drop a JSON + Markdown file and restart.

InstallationConfiguration