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- 1Download the installer from the waitlist confirmation email
- 2Run neura-agent-win-x64.exe and follow the setup wizard
- 3Launch Neura from the Start menu or system tray
- 4Sign in with your Imara account to activate
macOS
macOS 12 Monterey or later (Apple Silicon & Intel)
neura-agent-mac.dmg- 1Download the .dmg from the waitlist confirmation email
- 2Open the disk image and drag Neura to Applications
- 3Launch Neura from Applications or Spotlight
- 4Grant accessibility and notification permissions when prompted
Linux
Ubuntu 22.04+, Fedora 38+, or equivalent (x64)
neura-agent-linux.AppImage- 1Download the AppImage or .deb package
- 2For AppImage: chmod +x neura-agent-linux.AppImage && ./neura-agent-linux.AppImage
- 3For Debian/Ubuntu: sudo dpkg -i neura-agent-linux.deb
- 4Launch from your app launcher or run neura from the terminal
First run
After installation, Neura walks you through a short setup flow.
Sign in
Authenticate with your Imara account or create one.
Permissions
Grant file access, notifications, and accessibility permissions.
Preferences
Set autonomy level, theme, and sync preferences.
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.
neura startStart the Neura agent daemon
neura stopStop the running agent
neura statusCheck agent status, version, and sync state
neura updateCheck for and apply available updates
neura config set <key> <value>Set a configuration value
neura config get <key>Read a configuration value
neura logsStream real-time agent logs
neura logs --tail 100Show last 100 log entries
neura task listList active and recent tasks
neura task cancel <id>Cancel a running task by ID
neura memory exportExport agent memory as JSON
neura memory clearClear agent memory (requires confirmation)
neura plugin listList 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.
npm install @imara/neura-sdkimport { 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 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)// 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',
})// 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.
general.autoUpdatetruegeneral.launchOnStartuptruegeneral.theme"system"agent.autonomyLevel"L1"agent.maxStepsPerTask20agent.confirmIrreversibletruesync.enabledtruesync.interval300privacy.telemetrytrueprivacy.localInferencetrueArchitecture
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 WaitlistiPhone
Seamless handoff between Mac and iPhone. Shortcuts integration, Siri commands, and widget support.
Join iPhone WaitlistFAQ
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.