v1.1.0 — 27 tools, 3 providers

Your phone,
now an AI agent

Nova Agent runs on Android via Termux, giving any AI model direct, native access to your camera, GPS, SMS, sensors, files, and more. No root required.

↓ Install in 5 minutes View on GitHub →
27
Native Tools
3
AI Providers
Free
via Gemini
~5m
Setup Time
nova-agent — Termux
Nova Agent v1.1.0 · Gemini 2.0 Flash
History loaded — 8 messages
 
Why Nova Agent

The AI that can actually do things

Most AI chatbots are text-only. Nova Agent bridges the gap between language models and real-world phone actions — all on-device.

📱
Native Android Hardware
Termux:API exposes camera, GPS, SMS, contacts, sensors, volume, clipboard, and more — 27 tools total.
🧠
Persistent Memory
Conversations save to disk automatically. Your agent remembers yesterday's context when you reopen it today.
⚡
Multi-Tool Chains
One prompt can trigger a full workflow: take a photo, analyze it with AI vision, then SMS the result to a contact.
🔓
No Root Required
Everything runs in Termux userspace. No rooting, no custom ROMs, no unlocking bootloaders.
🌐
Three AI Providers
Gemini (free), OpenAI, and Anthropic — all with real function calling. Switch any time with novax configure.
🔒
Fully On-Device
Your location, messages, and files never leave the device. API calls go only to your chosen AI provider.
Tool Library

27 native phone tools

13 new tools in v1.1.0 — every action goes through Termux:API, the official Android bridge.

Persistent Memory

It remembers what
you asked yesterday

Conversations are automatically saved to ~/.nova_agent/history.json. When you reopen Nova Agent, it picks up exactly where you left off.

✓ 50-message rolling window kept on disk
✓ Type history to review past conversation
✓ Type clear to wipe and start fresh
✓ novax --no-history for private sessions
✓ novax --clear-history to delete saved history
~/.nova_agent/history.json — 8 msgs
Yesterday · You
What's the weather and my battery level?
Nova
28°C sunny in New Delhi. Battery at 72%, not charging.
Today · You
Compare with yesterday?
Nova
Yesterday: 28°C, 72% battery. Today: 31°C partly cloudy, battery now 94%, charging. 3° warmer, fully charged.
AI Providers

Three providers, one agent

All three support native function calling (tool use). Switch with novax configure in under 30 seconds.

Gemini
Free Tier Available

Google's fastest multimodal model. Generous free quota via AI Studio — the best way to start at zero cost.

  • gemini-2.0-flash
  • gemini-2.0-pro-exp
  • gemini-1.5-pro
  • gemini-1.5-flash
OpenAI

Industry-standard function calling with the best ecosystem support. Streaming responses included.

  • gpt-4.1
  • gpt-4o
  • gpt-4o-mini
  • o4-mini
Anthropic

Claude's careful reasoning and extended context shine in complex multi-step phone automation workflows.

  • claude-opus-4-5
  • claude-sonnet-4-5
  • claude-3-5-haiku
  • claude-3-5-sonnet
Quick Start

From zero to AI agent
in 5 minutes

Install Termux from F-Droid (not the Play Store — the Play Store version lacks the right permissions), then run these commands.

01
Install Termux dependencies
Set up Node.js, Python 3, and install the Termux:API app from F-Droid alongside Termux.
# In Termux terminal
pkg install nodejs python termux-api
02
Install Nova Agent globally
One npm command — the novax command becomes available everywhere.
npm install -g nova-agent
03
Configure your AI provider
Interactive wizard — select provider, choose a model, and paste your API key. Gemini has a free tier.
novax configure
04
Start talking to your phone
Launch interactive mode or run a one-shot query. Your phone is now AI-controlled.
# Interactive mode (with history)
novax
# One-shot query
novax ask "Where am I right now?"
Real Examples

What you can ask Nova Agent

📸
"Take a photo and describe what you see"
take_photo → analyze_photo → text
📍
"Where am I? SMS my location to mom"
get_location → send_sms
🔋
"Battery low? Lower brightness to 50%"
get_battery_status → set_brightness
🎵
"Play my walking playlist, volume 70%"
media_play → set_volume
📝
"Read my notes file and summarize it"
list_files → read_file → summary
🌡️
"Log today's step count to a file"
get_sensor(pedometer) → write_file
Open Source · MIT License

Build something
extraordinary

Nova Agent is MIT-licensed and built for the community. Add new tools, support new models, or build entire automations on top of the agent framework.

☆ Star on GitHub Read CONTRIBUTING.md