Docs — Nano by Genesis Group

// INTRODUCTION

Getting Started

Welcome to Nano — the scriptable API terminal built by Genesis Group. This page covers everything you need to know to go from zero to running your first script.

⚡

Nano requires no installation, no account, and no download. Everything runs in your browser at nano.genesisvault.xyz.

What is Nano?

Nano is a browser-based API terminal. It lets you interact with any API on the internet using a simple command-line interface — without writing a single line of code.

You bring your own API keys. Nano brings the commands. Your data never leaves your device.

What makes it different:

Unlimited API key storage (locally in your browser)
Custom scripting language — .nvault — to automate multi-step workflows
Multi-AI support — Groq, Gemini, OpenRouter, Qwen in one place
Built-in recon tools — subdomain enum, DNS, WHOIS, IP lookup, SSL
Zero server — no data is sent anywhere except the APIs you call

Quick Start

1

Open the Terminal

Go to terminal.html. The terminal loads immediately — no login required.

2

Try a free command

Type ip 8.8.8.8 and press Enter. This runs an IP lookup with no key needed.

3

Add an API key

Type key GROQ_KEY your-key-here to save a key directly from the terminal. Or go to the API KEYS tab and use the + ADD KEY form.

4

Run an AI command

Once you've added your Groq key, type groq "explain what DNS is" and hit Enter.

5

Write your first script

Go to SCRIPTS tab → + NEW → name it myrecon → write your commands → Save. Then type run myrecon in the terminal.

// API KEYS

Adding Keys

Most commands that call external APIs require a key. Nano makes it easy to manage unlimited keys from any provider.

Method 1 — Terminal command

terminal

          # Syntax: key KEY_NAME value

          $ key GROQ_KEY sk-xxxxxxxxxxxxxxxxxxxx

          [+] Key saved: GROQ_KEY

          $ key GEMINI_KEY AIzaSyxxxxxxxxxxxxxxxxx

          [+] Key saved: GEMINI_KEY

Method 2 — API Keys tab

Click the API KEYS tab in the terminal. Scroll to the bottom and use the + ADD NEW KEY form. Type any name, paste your value, click ADD.

ℹ️

Key names are automatically uppercased and sanitized. groq key becomes GROQ_KEY. Use underscores for multi-word names.

Key Storage

All API keys are saved to your browser's localStorage under the key nv3_keys. They persist across page refreshes and browser restarts.

⚠️

Keys are stored in your browser only. Clearing browser data or using incognito mode will erase them. Export important keys before clearing browser storage.

To delete all saved data, type vault-reset in the terminal. This clears all keys and scripts permanently.

// .NVAULT LANGUAGE

.nvault Scripts

The .nvault format is Nano's custom scripting language. It lets you chain multiple commands together, use variables, and automate full API workflows — all in a simple, readable syntax.

Scripts are saved in the SCRIPTS tab, downloaded as .nvault files, and can be imported back at any time.

Syntax

Each line in a .nvault script is one of:

A comment — starts with #
A directive — starts with #@
A variable declaration — set NAME = value
A command — any valid terminal command
A blank line — ignored

example.nvault

          # This is a comment — ignored by the runner

          #@require GROQ_KEY

          set TARGET = genesisvault.xyz

          set DEPTH = full

          dns $TARGET

          ip $TARGET

          subdomain $TARGET

          groq "summarize the recon results"

Variables

Variables are declared with set and referenced anywhere in the script with $VARNAME.

variables.nvault

          # Declare variables

          set TARGET = example.com

          set CITY = Lagos

          # Use variables in commands

          dns $TARGET

          weather $CITY

          subdomain $TARGET

          # Variables in AI prompts

          groq "analyze the attack surface of $TARGET"

ℹ️

Some commands automatically set variables. For example, subdomain saves the first 10 results to $SUBDOMAINS. Check command output for auto-set variables.

Comments

Any line starting with # (that is not a directive) is a comment and is ignored by the runner.

comments.nvault

          # Full line comment — ignored

          dns example.com  # inline comments not supported

          # Use comments to document your scripts

Directives

Directives start with #@ and give the script runner special instructions.

Directive	Usage	Description
#@require	#@require GROQ_KEY	Declares that this script needs a specific API key. Shows a warning if the key is missing before running.
#@name	#@name My Recon Tool	Sets a display name for the script shown in the scripts list.
#@desc	#@desc Full subdomain recon	Sets a description shown when hovering the script in the list.

// COMMANDS

All Commands

Type help in the terminal to see all commands. Use help <command> for detailed usage.

Network & Recon

Command	Usage	Key	Description
ip	ip <address>	FREE	IP geolocation — country, city, ISP, timezone, coordinates.
dns	dns <domain>	FREE	DNS lookup via Google DNS. A, MX, NS, TXT, CNAME records.
whois	whois <domain>	FREE	Domain registration data via RDAP protocol. No key needed.
ssl	ssl <domain>	FREE	SSL/TLS certificate info — expiry, issuer, grade.
headers	headers <url>	FREE	HTTP response headers from any URL.
subdomain	subdomain <domain>	FREE	Subdomain enumeration via crt.sh certificate transparency logs.
port	port <host> <port>	FREE	Check if a port is open or closed on a host.
weather	weather <city>	OPENWEATHER_KEY	Current weather conditions for any city.

AI Commands

Nano supports multiple AI providers. Each requires its own API key stored under the correct name.

Command	Usage	Key Required	Model
groq	groq "<prompt>"	GROQ_KEY	llama-3.1-8b-instant — fastest inference
gemini	gemini "<prompt>"	GEMINI_KEY	Gemini 2.0 Flash — Google AI
ai	ai "<prompt>"	AI_KEY	OpenRouter — access 100+ models
qwen	qwen "<prompt>"	QWEN_KEY	Alibaba Qwen — strong at code & analysis
qwen-analyze	qwen-analyze "<context>"	QWEN_KEY	Analyze last command output with AI
qwen-recon	qwen-recon <target>	QWEN_KEY	AI-powered recon report on a target domain

💡

After running any recon command, use qwen-analyze "summarize findings" to get an AI analysis of the last output automatically piped in.

Crypto & Finance

Command	Usage	Key	Description
crypto	crypto <symbol>	FREE	Live crypto price, 24h change, rank. BTC, ETH, SOL, etc.
stock	stock <ticker>	ALPHAVANTAGE_KEY	Stock price and basic market data.

Utility Commands

Command	Usage	Description
key	key <NAME> <value>	Add or update an API key from the terminal.
clear	clear	Clear the terminal output.
export	export	Download terminal output as a .txt file.
vault-reset	vault-reset	Clear all saved keys and scripts from localStorage.
help	help [command]	List all commands or get help for a specific command.
echo	echo <text>	Print text to the terminal. Useful in scripts for labels.
run	run <script-name>	Execute a saved .nvault script.
load	load <script-name>	Load a script into the editor without running it.
list	list	List all saved scripts.
save	save	Save the current script in the editor.

// SCRIPT EXAMPLES

Ready-to-Use Scripts

Copy any of these scripts into the Nano editor and run them. Replace the variable values with your targets.

Full Recon Script

A complete recon script that runs DNS, WHOIS, subdomain enum, SSL check, and then pipes results into Groq for AI analysis.

full-recon.nvault

          # Full Domain Recon Script

          # Requires Groq key for AI analysis

          #@require GROQ_KEY

          set TARGET = example.com

          # Phase 1: Basic recon

          echo ── DNS RECORDS ──

          dns $TARGET

          echo ── WHOIS DATA ──

          whois $TARGET

          echo ── SSL CERTIFICATE ──

          ssl $TARGET

          # Phase 2: Subdomain enum

          echo ── SUBDOMAINS ──

          subdomain $TARGET

          # Phase 3: AI analysis

          echo ── AI ANALYSIS ──

          groq "Based on the recon data for $TARGET, summarize the attack surface, identify any concerns, and suggest next steps for a security assessment."

          # Export findings

          export

Crypto Portfolio Script

Check prices for multiple crypto assets in one script. No API key needed.

portfolio.nvault

          # Crypto Portfolio Checker

          # No API key required

          echo ━━ PORTFOLIO SNAPSHOT ━━

          crypto BTC

          crypto ETH

          crypto SOL

          crypto BNB

          crypto ADA

          echo ━━ DONE ━━

Multi-AI Comparison Script

Ask the same question to multiple AI providers and compare responses. Requires all three keys.

ai-compare.nvault

          # Multi-AI Comparison

          #@require GROQ_KEY

          #@require GEMINI_KEY

          #@require AI_KEY

          set QUESTION = What are the top 3 OWASP vulnerabilities in 2025?

          echo ── GROQ (Llama 3.1) ──

          groq "$QUESTION"

          echo ── GEMINI 2.0 Flash ──

          gemini "$QUESTION"

          echo ── OPENROUTER ──

          ai "$QUESTION"

// FAQ

Frequently Asked Questions

Are my API keys safe? ▶

Yes. Keys are stored only in your browser's localStorage. They never leave your device and are never sent to any Nano or Genesis Group server. The only outbound requests are directly to the APIs you call.

What happens if I clear my browser data? ▶

All saved keys and scripts will be erased. Before clearing browser data, export your scripts from the SCRIPTS tab and note down your API keys. You can re-import scripts after.

Can I use Nano on mobile? ▶

Yes. Nano is fully responsive. The sidebar collapses on mobile and all features are accessible via tabs. The terminal input works with any mobile keyboard.

Can I add any API, not just the ones in the library? ▶

Yes. The key system is fully dynamic — you can add any key with any name. However, only commands built into Nano can execute API calls. Custom APIs would need to be added as new commands via a future plugin system.

Why is my command returning an error? ▶

The most common causes are: (1) missing API key — check the API KEYS tab, (2) invalid key — verify it on the provider's dashboard, (3) rate limit exceeded — wait and retry, (4) the target domain/IP is invalid. Run help <command> to check correct usage.

How do I share a script with someone? ▶

Go to SCRIPTS tab, click DOWNLOAD on your script to get a .nvault file. Send that file to anyone. They can import it in their Nano terminal using the ↑ IMPORT button in the SCRIPTS tab.

Is Nano free to use? ▶

Nano itself is completely free. You only pay for API calls if the APIs you use have paid tiers — but all APIs in our library have free plans. Many core commands (IP lookup, DNS, subdomain enum, crypto prices) require no key at all.

What is Genesis Group? ▶

Genesis Group is the team behind GenesisVault — a cybersecurity platform targeting the African developer and security community. Nano is one of the tools built under the Genesis Group umbrella. Visit genesisvault.xyz to learn more.

Tips & Tricks

💡

Use arrow keys to navigate command history. Up/Down arrows cycle through previously entered commands.

💡

Copy terminal output with the ⎘ COPY button at the top of the terminal, or export as a .txt file with ↓ EXPORT.

💡

Chain AI with recon — after any recon command, run qwen-analyze "what should I investigate next?" for AI-guided next steps.

💡

Use echo in scripts to add section headers. echo ── PHASE 1: DNS ── makes long script output easy to read.

ℹ️

Free commands first — many commands work with no key at all. Start with ip, dns, subdomain, crypto, whois before setting up keys.