Heliox-OS Agent工作流

🚀 Installation

Option 1: Download Compiled Desktop App (Recommended)

The easiest way to get started is to download the pre-compiled installer for your operating system.

1. Go to the GitHub Releases page. 2. Download the installer for your OS: - Windows: Heliox OS_x64-setup.exe - macOS (Apple Silicon): Heliox OS_aarch64.dmg - macOS (Intel): Heliox OS_x86_64.dmg - Linux: .AppImage or .deb 3. Install the app. 4. Open Heliox OS and enter your API Key (e.g., Gemini, OpenAI, Claude) in the Settings tab.

Note: The Python backend requires Python 3.11+ installed on your system. You must start the local daemon manually for now.

Option 2: Build from Source (For Developers)

If you want to contribute or modify Heliox OS, build it from the source code:

1. Install the Python daemon:

git clone https://github.com/VyomKulshrestha/Heliox-OS.git
cd Heliox OS/daemon
pip install -e ".[full,dev]"

2. Choose your LLM: Local (Ollama): ollama pull llama3.1:8b -> ollama serve Cloud (Gemini/OpenAI/Claude): Add your API key in the app GUI.

3. Run the daemon:

cd daemon
python -m pilot.server

4. Run the frontend:

cd tauri-app/ui
npm install
npm run dev

`npm install` Fails:

Try clearing the npm cache and reinstalling dependencies:

npm cache clean --force
npm install

Also ensure that Node.js and npm are installed correctly.

---

Example Commands

"Show me my system info"
"Take a screenshot and read the text on screen"
"Go to Wikipedia's page on AI and summarize the first 3 paragraphs"
"Create a Python project with tests and run them"
"Kill the process using the most CPU"
"Monitor my CPU and alert me when it goes above 80%"
"Download a file and show me a tree of the folder"
"List all .py files on my Desktop"
"Set my volume to 50%"
"Create a CSV with sales data and analyze it"
"What's my IP address?"
"Install Firefox"

Environment Variables

env_get · env_set · env_list

Configuration

Config file: ~/.config/pilot/config.toml

[model]
provider = "ollama"           # "ollama" | "cloud"
ollama_model = "llama3.1:8b"
cloud_provider = "gemini"     # "gemini" | "openai" | "claude"

[security]
root_enabled = false
confirm_tier2 = true
unrestricted_shell = false
snapshot_on_destructive = true

[server]
host = "127.0.0.1"
port = 8785

Missing API Key Errors:

If cloud models like Gemini, OpenAI, or Claude are not working: - Ensure your API key is added correctly in the application settings - Restart the application after updating the key

---

🧠 TRIBE v2 Cognitive Engine Integrations (v0.7.1)

Heliox OS is now fully neuro-adaptive, integrating Meta's TRIBE v2 Cognitive Engine directly into the operating logic:

1. Neural Cognitive HUD: Tracks real-time Saliency and Brain Load via screen vision buffer, mapped onto the Svelte UI.
2. Dynamic TTS Stress-Pacing: JARVIS automatically slows down voice generation if you are engaged in high cognitive-load tasks.
3. Neuro-Safe Destructive Gate: High-risk actions (e.g., recursive deletes) evaluate cognitive stress first. If you are distracted, a strict 10-second auditory confirmation gate holds the process.
4. Subconscious Persona Fingerprint: The Subconscious background loop learns your neural visual plasticity constraints and encodes them to persona.md to align UIs to your brain.
5. Attention-Optimized Notifications: The notification pipeline dynamically buffers trivial background alerts until the system detects a "cortical transition" (a low-load resting state).
6. ReAct Neural Cost Estimator: Tasks predict aggregate cognitive demand proactively logic. If executing a plan risks exceeding mental bandwidth, JARVIS pauses.
7. JARVIS Intent Classifier: Fully integrated native intent fusion classifying spoken commands against current workload intensity.

Package Management

package_install · package_remove · package_update · package_search Auto-detects: winget, choco, brew, apt, dnf, pacman

🔌 Plugin Ecosystem

Heliox OS ships with 3 flagship plugins and supports community-built extensions:

Drop custom plugins into ~/.heliox/plugins/ — they're auto-discovered at startup after Ed25519 signature verification. Production registries can verify against bundled trusted public keys; local plugin packages can include plugin.ed25519.pub with plugin.ed25519.sig. Unsigned, untrusted, or tampered plugins are rejected before their manifest or code is loaded.

{
  "name": "my-plugin",
  "version": "1.0.0",
  "tools": [{"name": "my_tool", "inputs": ["arg1"], "action_type": "api_call"}]
}

🛠️ Troubleshooting