Skip to content

README.md

Latest commit

 

History

History
82 lines (61 loc) · 3.91 KB

README.md

File metadata and controls

82 lines (61 loc) · 3.91 KB
Raw

🖥️ Angela — Local Linux AI Assistant

Angela is a sleek, modern, and interactive glassmorphic web assistant designed to translate natural language queries into accurate, one-line Linux terminal commands. Powered locally by Google's Gemma open-weight model, Angela allows you to manage system administration, file operations, and development tasks without needing to memorize complex bash parameters.

image

🚀 Key Features

  • Natural Language to Bash: Ask for any operation in plain English, and receive an instant, copy-ready terminal command.
  • Vibrant Cyberpunk UI: Features a glassmorphic dashboard styled with glowing gradients, clean layout components, and custom monospaced typography.
  • Simulated Console Display: Rendered outputs mimic a true Linux CLI environment complete with title bar, window actions, and status colors.
  • Quick Suggestions: High-frequency pre-configured chips (like checking disk space, killing ports, and archiving folders) for immediate testing.
  • Local Privacy & Speed: No external API keys or cloud connections required. Your queries and system layout stay private on your local machine.
  • Copy-to-Clipboard: Copy commands directly with instant visual feedback state transitions.

🔮 The Power of Gemma for Devops

At the heart of Angela is Gemma, a family of lightweight, state-of-the-art open models built from the same research and technology used to create the Google Gemini models.

Why Gemma is Ideal for this Use Case:

  1. Strict Data Privacy: System operations and file path queries frequently contain private information (usernames, directory hierarchies, project structures). By running Gemma locally via Ollama, no query data is sent to external clouds or third-party servers.
  2. Low Latency: Local execution means zero API roundtrip lag. Commands generate instantly right on your machine.
  3. Resource Efficiency: The quantized Gemma models (like gemma4:e4b) run exceptionally well on normal developer laptops, requiring minimal RAM and processing overhead while retaining robust language understanding and code-generation capabilities.
  4. Specialist Developer Assistant: Gemma is highly proficient in coding, syntax generation, and following system configuration patterns, making it a perfect assistant for sysadmins, DevOps engineers, and bash novices alike.

🛠️ Tech Stack

  • Frontend: HTML5, Vanilla CSS (Glassmorphism & Neon Design System), and JavaScript (Fetch API & Clipboard API).
  • Backend: Node.js, Express, and CORS middleware.
  • AI Integration: Ollama Node.js SDK connecting to a local Ollama service running the gemma4:e4b model.

📦 Setup and Running Locally

Prerequisites

  1. Node.js (v16+) installed.
  2. Ollama installed on your system (Download Ollama).
  3. The Gemma model pulled and running locally: 
    ollama pull gemma4:e4b

Running the App

  1. Clone / Navigate to the project directory:

    cd linux-ai

  2. Install dependencies:

    npm install

  3. Start the Server:

    node server.js

    The server will startup on port 3000: Running on port 3000

  4. Open the Web App:

    • Open http://localhost:3000 in your web browser (the server serves the UI directly!).
    • Alternatively, you can double-click and open the local index.html file in any browser.

📖 Usage Example

  1. Type a request in the input field: "find all files larger than 500 MB in the current directory and list their paths"
  2. Press Enter or click Generate.
  3. The mock console displays the result: 
    find . -type f -size +500M
  4. Click Copy to save the command to your clipboard.