Hi! Hold Space to talk.
?
⭐
✨
IDLE — click character to change

Shadow

Your AI coworker. Powered by Gemini Live.

Watch Demo View on GitHub
Gemini Live Agent Challenge 2026
Interactive Demo

See Shadow in action

A simulated conversation showing how Shadow organizes a messy Desktop.

Hi! Hold Space to talk.
?
⭐
✨
Shadow — Desktop Assistant
Capabilities

30 tools. One agent.

Shadow can read, write, search, organize, automate, and navigate your entire Mac.

Architecture

Built for real work

Swift macOS app, Python FastAPI backend, Gemini Live streaming, ADK orchestration.

Shadow Architecture Diagram
30
Tools
4
Gemini Models
10
Languages
Get Started

Up and running in 3 steps

1

Clone & Setup

Clone the repo and install the Python backend dependencies.

git clone https://github.com/AnassKartit/shadow.git cd shadow/backend pip install -r requirements.txt
2

Add your API key

Set your Gemini API key as an environment variable. No other config needed.

# .env or export export GOOGLE_API_KEY=your_key_here
3

Start talking

Run the backend, open the Swift app, and hold Space to talk to Shadow.

uvicorn main:app --port 8000 # Open Shadow.xcodeproj in Xcode # Build & Run (Cmd+R)
Checking backend status...
Google Cloud Run
endpoint: shadow-backend...us-central1.run.app
status: checking...
tools: --
model: gemini-2.5-flash-native-audio