🦁 GeniClaw - Your AI Terminal Assistant

GeniClaw is a powerful, local-first AI assistant manager that connects multiple AI providers (Gemini, OpenAI, Claude, Groq, DeepSeek, Grok) to your workflow. It runs as a background service (daemon) on your machine, managing conversation history, project sessions, and token usage efficiently.

🚀 Key Features

• 🧠 Multi-Provider Support:
  • Google Gemini (1.5 Flash/Pro, 2.0 Flash)
  • OpenAI (GPT-4o, GPT-3.5)
  • Anthropic (Claude 3.5 Sonnet, Opus)
  • Groq (Llama 3, Mixtral - Ultra Fast)
  • DeepSeek (Coder, Chat)
  • xAI (Grok Beta)
• 🔎 Web Search: Integrated Brave Search allows the AI to Google things for you in real-time.
• 🔀 Task Routing: Assign different models to different tasks! (e.g., Use Groq for fast Chat, Gemini for heartbeat/cron jobs).
• 📂 Session Management: Create separate "folders" (sessions) for different projects.
• 💾 Smart Memory: Automatically manages conversation context and prunes old messages to stay within token limits.
• 🖥️ Terminal UI (TUI): A beautiful interactive interface to manage keys, models, and sessions.
• ⚡ Queue-Based: Robust message processing ensures no data is lost.

🛠️ Setup

Prerequisites

• Node.js (v18 or higher)
• API Keys: You need at least one API key from a supported provider:
  • Google AI Studio
  • OpenAI
  • Anthropic
  • Groq
  • DeepSeek
  • Brave Search (Optional, for Web Search)
• Telegram Bot Token (Optional, for chatting via Telegram).

Installation

1. Install via NPM:

   npm install -g @thelapyae/geniclaw

2. Run Setup:

   geniclaw setup

🎮 How to Use

GeniClaw is managed entirely through its Interactive TUI.

1. Start the TUI

geniclaw

2. Main Menu Options

• 🤖 Select AI Provider & Model: Choose which brain you want to use (Gemini, GPT-4, Claude, etc.).
• 🔑 Manage API Keys: Enter keys for different providers.
• 🔀 Task Routing: Configure which provider handles Chat vs. Background Tasks.
• 🔎 Web Search Config: Set your Brave Search API key to enable internet access.
• Start/Stop Daemon: Control the background process.

3. Chatting

• Telegram: Chat with your bot.
• CLI: geniclaw send "Hello!"

web Search

Just ask:

• "Search for the latest heavy metal news"
• "Google the price of Bitcoin"
• "/search Who won the super bowl?"

🔒 Safety & Technology

GeniClaw creates a secure, local-first environment for your AI interactions.

Technology Stack

• Runtime: Node.js & TypeScript.
• State Management: Local JSON files (No external database required).
• API Integration: Uses official SDKs (Google Generative AI) and standard REST APIs (OpenAI-compatible) via node-fetch.
• Background Service: A lightweight daemon process manages the message queue.

Why is it Safe?

1. Local Data: All conversation history, sessions, and logs are stored locally on your machine in ~/.geniclaw/. Your data never leaves your computer except to go directly to the AI provider.
2. Direct Connection: GeniClaw connects directly to the AI APIs (Google, OpenAI, etc.). There is no "middleman" server collecting your data.
3. Open Source: The code is transparent. You can inspect exactly how your keys and data are used.
4. Key Security: API keys are stored in a local config file (config.json) on your machine.

⚠️ Important Notes

1. API Costs: Using commercial APIs (OpenAI, Anthropic) is not free. Costs depend on your usage. Groq and Gemini (Free Tier) offer free options.
2. Privacy: While GeniClaw is local, the AI Providers (Google, OpenAI, etc.) have their own data policies.
3. Daemon: The background process must be running for GeniClaw to reply.

Enjoy your AI Assistant! 🦁