FERAL

FERAL

One brain. Every device. Your entire life.

The open-source AI that connects to everything you own — your wristband, your smart glasses, your home, your computer, your phone, your robots. It learns how you live, builds your baseline, and runs things the way you would. Locally. Privately. Without asking permission from a cloud.

Star on GitHub
GitHub StarsLast CommitApache 2.0Python 3.11+

One brain. Connected to everything.

FERAL doesn't live in a chat window. It's wired into your physical and digital world — every device, every app, every sensor.

Wearables

Whoop, Oura Ring, wristbands

Heart rate, sleep, SpO2, skin temp — real-time

🏠

Smart Home

Lights, thermostat, locks, appliances

Direct local mesh — no cloud roundtrip

👓

Smart Glasses

Video stream, AR overlay

Hands-free interaction, scene understanding

🤖

Robots

ROS, serial, I2C, any actuator

If it has an API or radio, FERAL talks to it

💻

Your Computer

Screen, browser, files, terminal

Sees your screen, runs commands, automates workflows

📱

Your Phone

Push notifications, location, camera

GenUI alerts, geofencing, always with you

📡

Software & APIs

Calendar, email, Slack, Spotify, Notion

Morning briefings, auto-responses, deep integration

🎙️

Voice

Wake word, 3 providers, sub-200ms

Talk to your entire life, hands-free

All connections are local. Zero cloud dependency.

What it actually does

Shipped code. Not a roadmap.

🧠

Persistent Memory

Four tiers: working, episodic, semantic, execution log — plus a knowledge graph. FERAL remembers your entire life across sessions, devices, and reboots.

🎙️

Sub-200ms Voice

Wake word detection, OpenAI Realtime + Gemini Live streaming, interrupt-and-resume. Talk to your entire device ecosystem, hands-free.

🔌

Hardware Mesh

Bluetooth, serial, I2C, WiFi — lights, wristbands, glasses, robots, appliances. If it has an API or radio, FERAL controls it locally.

Proactive Intelligence

Watches your baseline — health, screen, calendar, environment. Speaks up when something matters. Morning briefings, anomaly alerts, coaching.

🎨

Generative UI

The brain generates UI on the fly — charts, forms, cards, dashboards. Push to any screen. Companies provide a JSON schema; FERAL renders it.

🔐

Three Autonomy Levels

Strict, hybrid, or loose. Real enforcement with approval gates and safety classification. You decide how much control to hand over.

🖥️

Full Computer Use

Screen capture, browser automation, file operations, bash execution. FERAL sees your screen and acts on it — like OpenClaw, but wired into everything else.

🪞

Digital Twin

Ask 'what would I think about this?' — FERAL builds a model of your preferences, decisions, and reasoning from your history.

How it works

Not another chatbot. A spatial agentic OS.

01

Brain runs locally

Python + any LLM (OpenAI, Anthropic, Gemini, Ollama). All inference on your machine. No data leaves unless you want it to.

02

Devices connect via mesh

WebSocket + HUP protocol. Wristband, glasses, home sensors, phone, desktop — all talk directly to the brain. No cloud relay.

03

It learns your baseline

4-tier persistent memory builds a living model of your routines, preferences, health patterns, and environment over time.

04

It acts proactively

Detects anomalies in your data. Suggests optimizations. Sends you a morning briefing. Dims the lights when your heart rate spikes. Without being asked.

05

You control the autonomy

Strict: asks before every action. Hybrid: safe stuff auto-executes, risky asks first. Loose: full autopilot — you review the log.

Get started in 60 seconds

curl -sSL https://raw.githubusercontent.com/FERAL-AI/FERAL-AI/main/scripts/install.sh | bash

Creates ~/.feral-env, installs everything, runs setup wizard.

Join the pack

FERAL is open source. Contribute skills, hardware adapters, GenUI providers, or just break things and file issues.