IV

Imara Vision

Agentic Technology Platform

DocsNeura Agent

Neura Desktop Agent

Build, install, and configure the Neura agentic AI on your desktop. Available for Windows, macOS, and Linux.

System requirements

Minimum specs to run the Neura desktop agent.

OS

Windows 10+, macOS 12+, Ubuntu 22.04+

Architecture

x64 (Intel/AMD), ARM64 (Apple Silicon)

RAM

8 GB minimum, 16 GB recommended

Disk

4 GB free space

Installation

Choose your platform and follow the step-by-step guide.

Windows

Windows 10 or later (x64)

neura-agent-win-x64.exe
  1. 1Download the installer from the waitlist confirmation email
  2. 2Run neura-agent-win-x64.exe and follow the setup wizard
  3. 3Launch Neura from the Start menu or system tray
  4. 4Sign in with your Imara account to activate

macOS

macOS 12 Monterey or later (Apple Silicon & Intel)

neura-agent-mac.dmg
  1. 1Download the .dmg from the waitlist confirmation email
  2. 2Open the disk image and drag Neura to Applications
  3. 3Launch Neura from Applications or Spotlight
  4. 4Grant accessibility and notification permissions when prompted

Linux

Ubuntu 22.04+, Fedora 38+, or equivalent (x64)

neura-agent-linux.AppImage
  1. 1Download the AppImage or .deb package
  2. 2For AppImage: chmod +x neura-agent-linux.AppImage && ./neura-agent-linux.AppImage
  3. 3For Debian/Ubuntu: sudo dpkg -i neura-agent-linux.deb
  4. 4Launch from your app launcher or run neura from the terminal

First run

After installation, Neura walks you through a short setup flow.

01

Sign in

Authenticate with your Imara account or create one.

02

Permissions

Grant file access, notifications, and accessibility permissions.

03

Preferences

Set autonomy level, theme, and sync preferences.

04

Ready

Neura runs in the background. Open from the system tray.

CLI Reference

Control the Neura agent from the terminal. All commands start with neura.

Terminal
neura start

Start the Neura agent daemon

neura stop

Stop the running agent

neura status

Check agent status, version, and sync state

neura update

Check for and apply available updates

neura config set <key> <value>

Set a configuration value

neura config get <key>

Read a configuration value

neura logs

Stream real-time agent logs

neura logs --tail 100

Show last 100 log entries

neura task list

List active and recent tasks

neura task cancel <id>

Cancel a running task by ID

neura memory export

Export agent memory as JSON

neura memory clear

Clear agent memory (requires confirmation)

neura plugin list

List installed plugins

neura plugin install <name>

Install a plugin from the registry

SDK & API

Integrate Neura into your applications using the official SDK. Install with npm or yarn.

Install
npm install @imara/neura-sdk
Initialize the agent
import { NeuraAgent } from '@imara/neura-sdk'

const agent = new NeuraAgent({
  apiKey: process.env.NEURA_API_KEY,
  model: 'neura-v1',
  autonomyLevel: 'L2', // goal-driven
})

await agent.connect()
Create and execute a task
// Create a task with natural language
const task = await agent.createTask({
  instruction: 'Summarize my meeting notes from today',
  context: {
    source: 'local-files',
    path: '~/Documents/meetings/',
  },
  constraints: {
    maxSteps: 10,
    requireConfirmation: true,
  },
})

// Listen for task events
task.on('step', (step) => {
  console.log(`[${step.type}] ${step.description}`)
})

task.on('confirmation', async (action) => {
  console.log('Agent wants to:', action.description)
  const approved = await promptUser(action.description)
  action.respond(approved)
})

const result = await task.execute()
console.log(result.summary)
Agent memory
// Access agent memory
const memories = await agent.memory.search({
  query: 'project deadlines',
  limit: 5,
})

// Store a preference
await agent.memory.store({
  key: 'preferred_summary_format',
  value: 'bullet-points',
  scope: 'user',
})
Custom plugins
// Register a custom plugin
agent.plugins.register({
  name: 'calendar-sync',
  version: '1.0.0',
  capabilities: ['read-calendar', 'create-events'],

  async onTask(context) {
    if (context.intent === 'schedule') {
      const events = await this.getCalendarEvents()
      return { availableSlots: findOpenSlots(events) }
    }
  },
})

Configuration

Configure via the settings UI or neura config set in the CLI.

Key
Type
Default
Description
general.autoUpdate
boolean
true
Enable automatic updates
general.launchOnStartup
boolean
true
Start Neura when the system boots
general.theme
string
"system"
"light", "dark", or "system"
agent.autonomyLevel
string
"L1"
Default autonomy: L0-L4
agent.maxStepsPerTask
number
20
Maximum steps before requiring confirmation
agent.confirmIrreversible
boolean
true
Always confirm before irreversible actions
sync.enabled
boolean
true
Enable cloud sync for memory and preferences
sync.interval
number
300
Sync interval in seconds
privacy.telemetry
boolean
true
Send anonymous usage data
privacy.localInference
boolean
true
Prefer on-device inference when possible

Architecture

How the desktop agent is structured internally.

Agent Core

The Sense-Interpret-Plan-Act-Verify-Adapt loop. Runs as a background daemon with a lightweight event system.

Local Inference

On-device model execution for fast, private inference. Falls back to cloud for large reasoning tasks.

Task Scheduler

Manages task queues, priority, and concurrency. Supports task chaining and dependency resolution.

Memory Store

Persistent vector memory for preferences, corrections, and context. Searchable and exportable.

Plugin System

Extend agent capabilities with community or custom plugins. Sandboxed execution environment.

Safety Layer

Bounded autonomy enforcement. Confirmation gates for irreversible actions. Full decision audit log.

Mobile companion

Neura syncs across desktop and mobile. Same agent, same memory, optimized for each device.

Android

Context-aware agent on the go. Background task execution, voice commands, and notification actions.

Join Android Waitlist

iPhone

Seamless handoff between Mac and iPhone. Shortcuts integration, Siri commands, and widget support.

Join iPhone Waitlist

FAQ

Windows 10+ (x64), macOS 12+ (Apple Silicon or Intel), or Ubuntu 22.04+ / Fedora 38+. At least 8 GB RAM, 4 GB disk space, and a broadband internet connection for cloud sync.

Neura runs locally on your machine with optional cloud sync. Core inference happens on-device for privacy and speed. Cloud sync keeps preferences, memory, and task history in sync across devices.

Yes. Core agentic features work offline. Cloud-dependent features like cross-device sync and large model calls will queue and resolve when connectivity returns.

Neura auto-updates by default. You can also check manually with `neura update` in the CLI, or disable auto-updates in Settings > General > Updates.

Ready to build with Neura?

Join the waitlist for early access to the desktop agent, SDK, and developer documentation.