FERAL AI — local AI brain for apps, devices, and memory

FERAL AI

One local brain for apps, devices, and memory.

FERAL runs locally as the control plane between your software and hardware. It keeps long-lived memory, learns your baseline patterns, and executes digital-twin actions with explicit policy gates. Developers ship headless API/CLI contracts, and FERAL renders structured Gen-UI surfaces on each user's system.

Apache 2.0Python 3.11+macOS & Linux

The origin story

The raccoon always wins.

Eight seconds. One lobster claw. No permission asked. This is FERAL in one clip — cunning, resourceful, and completely unbothered by who was supposed to own the prize.

AI was supposed to be personal. Instead it got captured — locked behind subscriptions, harvested for training, chained to someone else's cloud. FERAL is what happens when you break it out.

FERAL AI Connects to Every Device You Own

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 FERAL AI Can Do

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

Developers ship headless API/CLI contracts and app manifests; FERAL renders structured Gen-UI surfaces locally on each user's system.

🔐

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 — wired into every app, device, and signal in your life.

🪞

Digital Twin

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

How FERAL AI Works

Not another chatbot. A local control plane for apps, devices, and memory.

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.

Install FERAL AI

pip
pip install "feral-ai[all]"
feral setup
feral start

Lean path. Requires Python 3.11+. Recommended on macOS & Linux.

Join the FERAL AI Community

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