An ultra-fast, zero-bloat, 100% private Autonomous AI Agent running directly on your hardware. Built with pure TypeScript performance, sub-second cold starts, visual Web Setup Wizard, and an autonomous tool engine for web scraping, document generation, image synthesis, and scheduled tasks.
RoninAgent is equipped with built-in, production-grade tools for web scraping, file creation, document generation, image synthesis, and autonomous task scheduling.
Dual-engine scraper: fast static HTML parsing via cheerio with automated fallback
to puppeteer headless browser rendering for complex React/Vue SPAs and e-commerce
platforms.
The AI designs custom, responsive HTML/CSS layouts and compiles pixel-perfect A4 PDF reports,
invoices, and documents directly saved to your local workspace/.
Native creation of structured Excel spreadsheets (.xlsx) with formula support,
custom styling & borders, and formatted Word documents (.docx) with styled
typography and tables.
Direct text-to-image synthesis in chat using Together AI or X.AI (Grok) with automatic provider failover and instant visual response rendering.
Schedule autonomous background tasks with cron expressions or timers. Scans every 60s, executes tasks silently in the background, and sends live reports to your Telegram bot.
Modular Markdown skills (`agents/<agentId>/skills/*.md`). Pre-configured parsing rules for Amazon, Wildberries, Ozon, Temu, and List.am loaded dynamically by keyword match to save LLM tokens.
Cyberpunk-themed local Web UI for desktop productivity + remote Telegram bot with
ALLOWED_TELEGRAM_USER_IDS whitelist for safe on-the-go management.
Zero external database overhead (no Docker/Postgres/Pinecone). Embedded SQLite combined with
sqlite-vec extension for semantic vector similarity search & fast long-term memory.
Attach images directly into the chat interface. High-performance local resizing and optimization
via sharp before sending to multimodal LLMs.
What can you actually build and automate with RoninAgent in your daily workflow?
Scrape product specs and live prices across Amazon, Wildberries, Ozon, or Temu. The agent parses
SPA JavaScript rendering silently and exports styled Excel .xlsx sheets with
calculated price comparisons.
Control your local AI assistant on the go. Send voice notes, photos, or prompts to your Telegram bot. Secured with user ID whitelist so only you have remote command access.
Turn chat discussions into styled A4 PDF documents with custom CSS styling or editable Word
.docx contracts directly stored into your local workspace/ directory.
Schedule periodic web checks or API monitors using Cron syntax. The agent runs silently in the background every 60s and pushes instant digests or alerts straight to your phone.
Explore how RoninAgent seamlessly executes complex multi-step workflows.
"Scrape the current pricing and specs of top wireless headphones on Amazon and summarize key specs."
skills/amazon.md parsing rules.scrape_web_page({ url, renderJs: true }).cheerio.puppeteer headless Chrome for SPA content.[INFO] Matching skill: amazon.md (Keywords: amazon, price)
[TOOL] Executing scrape_web_page...
[SCRAPE] Dynamic SPA detected. Booting Headless Chrome...
[SUCCESS] Scraped 14,250 chars. Extracted 8 items.
[RESULT]
| Product Name | Price | Rating |
|---------------------|--------|--------|
| Sony WH-1000XM5 | $348.00| 4.6/5 |
| Bose QuietComfort | $279.00| 4.5/5 |
| Apple AirPods Max | $449.00| 4.7/5 |"Create a professional A4 sales report PDF with header styles, summary table, and footer."
generate_pdf({ html, filename: 'sales_report.pdf' }).workspace/sales_report.pdf.[TOOL] Executing generate_pdf...
[HTML] Compiling styled template (CSS Grid, Custom Fonts)...
[RENDER] Launching headless browser page (A4 layout)...
[SUCCESS] Saved file to workspace/sales_report.pdf (142 KB)
[DOWNLOAD LINK] RoninAgent/workspace/sales_report.pdf"Generate an Excel spreadsheet for monthly expenses with columns for Category, Budget, Actual, Difference, and SUM formulas."
generate_excel_document({ sheets, filename }) or
generate_word_document.
workspace/Expenses_August.xlsx.[TOOL] Executing generate_excel_document...
[EXCEL] Building sheet "August Expenses" (4 columns, 12 rows)...
[FORMULA] Applied '=SUM(C2:C11)' to total cell...
[STYLE] Added header fill #0D1B2A and grid border styling.
[SUCCESS] Generated workspace/Expenses_August.xlsx (18.4 KB)"Every morning at 09:00, scrape tech news, generate a summary, and send it to my Telegram channel."
[SCHEDULER] Task #42 triggered (Cron: 0 9 * * *).
[EXECUTE] Scraping HackerNews top stories...
[SUMMARY] Generated 5-bullet morning tech brief.
[TELEGRAM] Sending push alert to Chat ID 849204...
[STATUS] Task #42 completed successfully at 09:00:02."Generate a futuristic cyberpunk city skyline illuminated with cyan and neon magenta lights."
generate_image({ prompt }).[TOOL] Executing generate_image...
[PROVIDER] Using Together AI (Flux.1 Model)...
[SYNTHESIS] Processing prompt...
[SUCCESS] Generated 1024x1024 PNG image.
[RENDER] Displaying image in chat view.
No complex Docker setups or manual editing of .env files required. Launch in 1 minute
and configure everything visually.
When you run RoninAgent for the first time, it automatically detects missing configuration and opens the Web Setup Wizard. Easily enter your API keys (OpenRouter, Gemini, OpenAI, Together AI, Grok), set up local LLMs (Ollama, LM Studio), configure your Telegram Bot whitelist, and set HTTP basic authentication passwords visually!
Clone the repository or download the ZIP archive directly from GitHub.
Run npm start or double-click run.bat on Windows.
Open http://127.0.0.1:3000 in your browser. Configure API keys and settings
visually!
Requires Node.js (v20+) and npm (v9+). Fast and simple:
git clone https://github.com/nordevelopment/RoninAgent.git
cd RoninAgent
npm install
npm startDownload the ZIP file, extract it, and simply run the batch launcher:
# Double-click 'run.bat' in the project directory
# Or execute from command prompt:
.\run.batCompare RoninAgent with heavyweight alternatives. Raw performance metrics prove its efficiency on local hardware.
| Metric / Feature | ⚔️ RoninAgent | 🐳 Open WebUI | 💬 LibreChat | 📦 AnythingLLM | 🦞 OpenClaw |
|---|---|---|---|---|---|
| RAM Footprint | ~50 - 100 MB | 1.5 GB+ (Docker) | 1 GB+ (Docker Compose) | 500 MB+ (Electron/Docker) | 200 MB+ (pnpm/Docker) |
| Startup Time | < 1 second | 30 - 60 seconds | 30 - 60 seconds | 10 - 20 seconds | 5 - 10 seconds |
| Visual Setup Wizard | Yes (`/settings` UI) | Partial | No (Manual Config) | Yes | No |
| Installation | < 1 min (1 Command / `run.bat`) | 5+ min (Docker) | 10+ min (Compose) | 5+ min (Installer) | 5+ min (pnpm) |
| Web Scraper (Static + SPA) | Built-in (Cheerio + Puppeteer) | Requires Plugin | Requires Plugin | Basic Static | Built-in |
| PDF / Office Doc Generator | Built-in (PDF, XLSX, DOCX) | No | No | No | No |
| Task Scheduler (Cron/Timer) | Built-in (60s Background Engine) | No | No | No | Built-in |
| Database Overhead | SQLite + `sqlite-vec` (Embedded) | PostgreSQL / MySQL | MongoDB + Meilisearch | Vector DB + SQLite | SQLite (embedded) |
Everything you need to know about running and self-hosting RoninAgent.
No GPU required! You can run RoninAgent using lightweight cloud models (Google Gemini, OpenRouter, OpenAI, X.AI Grok) or run local open-weights LLMs via Ollama or LM Studio. It runs fast on any laptop.
Yes. RoninAgent is 100% self-hosted. All conversation logs, document workspace outputs, and vector RAG embeddings are saved inside your local SQLite database file on your hard drive. Zero external analytics.
While typical Web UIs are simple chat interfaces, RoninAgent is a full autonomous tool-executing agent. It generates styled A4 PDFs, native Excel/Word documents, scrapes dynamic web pages, and executes background scheduled tasks with sub-second boot times (~50MB RAM vs 1.5GB+ Docker containers).
It takes under 1 minute. Simply run npm start or double-click run.bat
on Windows. The visual Web Setup Wizard (/settings) opens
automatically so you can configure API keys in your browser without touching code or
.env files.
RoninAgent is 100% open-source and free under the MIT License. If it saved your hardware resources and boosted your AI workflow, consider supporting our project!
[ SPONSOR ON GITHUB ]