README.md

Linux Assistant

A web-based AI assistant interface for Linux systems, designed to bridge the gap between natural language interaction and system management.

Features

• Natural Language Interaction: Chat with your system using the Google Gemini API.
• System Commands: Execute non-destructive system commands directly from the interface.
• Web Search: Perform web searches using DuckDuckGo (via ddgs).
• News Aggregation: Fetch the latest news from the web.

Tech Stack

• Backend: Python (Flask)
• Frontend: HTML/CSS/JavaScript
• AI/APIs: Google Gemini, DuckDuckGo Search
• Tooling: uv (package management)

Getting Started

1. Clone the repository:

   git clone <repository-url>
   cd linux-assistant-webapp

2. Setup Environment: Ensure you have uv installed.

   uv sync

3. Configure: Ensure your environment variables (like GEMINI_API_KEY) are set. Refer to config/configs.json for structure.

4. Run:

   uv run python main.py

Contributors

Made with contrib.rocks.

---

License

MIT

---

Thank you and peace out!