๐Ÿš€ Autonomous Agent System

โš”๏ธ XKALIBER AGENT

Local. Autonomous. Unrestricted. Transform your local AI into a powerful System Agent with full file access, long-term memory, and real-time web connectivity. Works with Ollama and LM Studio.

ollama pull all-minilm

NEURO-CORE FEATURES

๐Ÿง 

Long-Term Memory

Smart VRAM recovery automatically unloads idle models when GPU memory is full. The agent autonomously decides which facts to save with local persistence in ~/.config/xkaliber-agent/.

๐Ÿ’พ

Live Memory UI

Real-time [X MEMS] counter and flashing [SAVING...] indicator. One-click full wipe button to instantly clear all session data and the physical vector database.

๐Ÿ›ก๏ธ

Secure Bash Execution

Run shell commands directly on your host machine. Private sudo UI field handles root privileges safely using sudo -S without ever saving to logs or neural memory.

๐ŸŒ

Netrunner Web Search

Real-time web search via DuckDuckGo with no API keys required. Inject live data into the neural stream for up-to-date responses.

๐Ÿ“ฑ

WhatsApp Integration

Link your account via QR code to send autonomous notifications directly to your phone. Perfect for alerts and system updates.

๐ŸŽ™๏ธ

Piper TTS

High-quality, 100% offline Text-to-Speech synthesis. Fast and reliable voice generation without any internet connection.

๐Ÿ“

File Manager

Full Read, Write, List, and Delete capabilities. Navigate and manipulate local directory structures seamlessly.

๐Ÿ‘๏ธ

Multimodal Vision

Drag-and-drop images or text files for instant vision analysis. Works with Llava, Bakllava, and other vision models.

๐Ÿ“ก

Remote Web Interface

Turn your host into a localized AI server. Mobile-optimized with dynamic viewports, anti-zoom scaling, and touch-friendly UI.

โšก

Autonomous Agent Mode

Toggle the Sys-Access harness for true AI agency. Continuous loop operation with tool selection for complex requests.

๐Ÿ”Œ

API Interaction

Make raw HTTP requests to interact with external REST APIs or local services. Seamless integration with your workflow.

๐Ÿ–ฅ๏ธ

CLI Version

After installation, type 'xagent' to spawn in terminal. Full-featured command-line interface for power users.

SYSTEM ARCHITECTURE

๐ŸŽจ Electron UI
Desktop interface with glassmorphic design
๐Ÿ“ฑ Web Interface
Mobile-accessible localhost server
โšก Renderer Process
Markdown rendering, syntax highlighting
๐Ÿง  Memory System
Vector DB + selective learning
๐Ÿ”ง Tool Engine
File, bash, API, TTS tools
๐Ÿฆ™ Ollama / LM Studio
Local LLM inference engine
๐ŸŒ Internet / Filesystem
Netrunner + local resources
๐Ÿ“ฒ WhatsApp
Notification delivery

COMMON USE CASES

๐Ÿ”ง Engineering
๐Ÿ› Troubleshooting
๐ŸŒ Live Search
๐Ÿ“Š System Status Review
๐Ÿ“ฑ App Control
๐Ÿ” Debugging
๐Ÿ–ฅ๏ธ Remote Control
๐Ÿ’ป Coding
๐Ÿ“‚ Asset Location
โšก Electron ๐Ÿฆ™ Ollama ๐ŸŽ™๏ธ Piper TTS ๐ŸŒ Netrunner ๐Ÿ“ฑ WhatsApp ๐Ÿง  Memory

LOCAL SETUP GUIDE

1

Install Ollama

Download and install Ollama from the official website. Ollama is required to run local AI models.

# Download from: https://ollama.com/download
# Or use winget: winget install Ollama.Ollama
2

Pull Required Model

Download the all-minilm model for embeddings (required for memory functionality).

ollama pull all-minilm
# Recommended models for best experience: ollama pull gemma4 ollama pull gwen3.5 ollama pull gwen3.6
3

Install Node.js

Ensure you have Node.js v18+ installed for running Electron.

# Download from: https://nodejs.org/
# Verify installation: node --version npm --version
4

Clone & Install Dependencies

Clone the repository and install npm dependencies.

git clone https://github.com/sneha-yadav1111/xkaliber-agent.git cd xkaliber-agent npm install
5

Launch Application

Start the Electron application.

npm start
6

Build Executable (Optional)

Package the application into a standalone .exe file.

npm run dist
1

Install Ollama

Install Ollama using Homebrew or download from the website.

# Using Homebrew (recommended): brew install ollama
# Or download from: https://ollama.com/download
2

Pull Required Model

Download the all-minilm model and recommended LLMs.

ollama pull all-minilm
# Recommended models: ollama pull gemma4 ollama pull gwen3.5 ollama pull gwen3.6
3

Install Node.js

Install Node.js using Homebrew.

brew install node
# Verify: node --version npm --version
4

Clone & Install Dependencies

Clone the repository and install dependencies.

git clone https://github.com/sneha-yadav1111/xkaliber-agent.git cd xkaliber-agent npm install
5

Launch Application

Start the Electron application.

npm start
6

Build App (Optional)

Package the application into a .app file.

npm run dist
1

Install Ollama

Install Ollama using the official installation script.

curl -fsSL https://ollama.com/install.sh | sh
2

Pull Required Model

Download the all-minilm model and recommended LLMs.

ollama pull all-minilm
# Recommended models: ollama pull gemma4 ollama pull gwen3.5 ollama pull gwen3.6
3

Install Node.js

Install Node.js using your package manager.

# Ubuntu/Debian: curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt-get install -y nodejs
# Arch: sudo pacman -S nodejs npm
# Fedora: sudo dnf install nodejs
4

Clone & Install Dependencies

Clone the repository and install dependencies.

git clone https://github.com/sneha-yadav1111/xkaliber-agent.git cd xkaliber-agent npm install
5

Launch Application

Start the Electron application.

npm start
6

Install CLI (Optional)

For command-line access, ensure xagent is in your PATH.

# After installation, type: xagent
# This spawns the agent in terminal
7

Build Package (Optional)

Create .AppImage or .deb package.

npm run dist

SEE IT IN ACTION

โšก Key Capabilities Demo'd:

  • Autonomous agent conversations with system access
  • Real-time web search via Netrunner
  • File operations and code execution
  • Long-term memory persistence
  • Vision analysis with multimodal models
  • TTS voice synthesis