Smartii

AI at the bottom of your browser. Press a key, screenshot the screen, get the answer.

Smartii is an unpacked Chrome extension that summons a small assistant bar at the bottom-middle of any page when you hit Ctrl+Shift+S. From there you can type a question, or press Ctrl+Shift+Enter to screenshot the whole visible page and let your chosen AI solve whatever is on it — a homework question, a stack trace, a UI puzzle, anything.

It works with free providers (Gemini, Groq, OpenRouter free models, Hugging Face) and paid ones (Claude, ChatGPT, Perplexity). Your API key lives only in your browser's sync storage. Smartii has no server.

---

Install (1 minute)

Smartii is shipped as an unpacked extension. Pick whichever flow you prefer.

🪄 Windows one-click installer (recommended on Windows)

Download Install-Smartii.exe from the latest release and double-click.

The installer detects every Chromium browser on your machine (Chrome, Edge, Brave, Vivaldi, Opera, Opera GX, Arc, Chromium, Yandex), downloads the latest Smartii zip to %LOCALAPPDATA%\Smartii\, copies that path to your clipboard, and opens the right chrome://extensions/ page in the browser you choose. You finish with one click — Load unpacked → Ctrl+V → Enter.

Source: installer/Install-Smartii.ps1. The .exe is the same script bundled with ps2exe; nothing more. Audit it, then run.

🍎 macOS one-click installer (recommended on Mac)

Download Install-Smartii.app.zip from the latest release, unzip it, and double-click Install-Smartii.app.

The installer detects every Chromium browser in /Applications (Chrome, Edge, Brave, Arc, Vivaldi, Opera, Opera GX, Chromium, Yandex, Helium, Thorium, Comet, Dia, Chrome Beta/Dev/Canary), downloads the latest Smartii zip to ~/Library/Application Support/Smartii/, copies that path to your clipboard, and opens the right chrome://extensions/ page in the browser you choose. You finish with — Load unpacked → ⌘V → Return.

First-launch Gatekeeper warning: the app is unsigned, so macOS will refuse to open it the normal way. Either right-click → Open → Open, or strip the quarantine flag once with xattr -dr com.apple.quarantine /path/to/Install-Smartii.app.

Source: installer/install-smartii.sh. The .app is just that script wrapped in a tiny bundle (Info.plist + icon) — no compiled binaries, no network listeners. Rebuild with bash installer/build-mac-app.sh.

🛠 Manual (any OS)

1. Download the Smartii-v*.zip from the latest release and unzip — or git clone https://github.com/platret/Smartii.git.
2. Open Chrome (or any Chromium browser — Edge, Brave, Arc, Opera) and go to chrome://extensions.
3. Turn Developer mode on (toggle, top-right).
4. Click Load unpacked and pick the Smartii folder.
5. The settings page opens automatically. Pick a provider, paste your API key, save.

To update later: git pull (or re-run the installer / re-download the zip) and click the ↻ button on the extension card.

---

Usage

Shortcut (Win/Linux)	Shortcut (Mac)	Action
Ctrl + Shift + S	⌘ + Shift + S	Toggle Smartii on the active tab
Alt + Shift + S	⌥ + Shift + S	Screenshot the visible screen + solve immediately
Alt + Shift + G	⌥ + Shift + G	⚡ Godmode — auto-solve & auto-fill everything (Pro)
Alt + Shift + X · double-Esc	⌥ + Shift + X · double-Esc	Panic — instantly hide Smartii and wipe the last answer
Enter in the input	Return in the input	Send your question (uses page text as context if empty)
Ctrl + Enter in the input	⌘ + Return in the input	Send your question and attach a screenshot
Esc	Esc	Close the bar

Change any shortcut at chrome://extensions/shortcuts.

The bar appears in the bottom middle of the page, either as a solid dark card or as a clear / glass card (configurable in settings).

---

Providers — where to get a key

Smartii supports a mix of free and paid providers. Start with a free one if you've never used an AI API.

Free / has free tier

Provider	Free?	Sign up	Get a key	Notes
Google Gemini	✅ Generous free tier	aistudio.google.com	Get API key	Best free vision model. Recommended starter.
Groq	✅ Free tier	console.groq.com	console.groq.com/keys	Extremely fast. Screenshots auto-use the free llama-4-scout vision model.
OpenRouter	✅ Many :free models	openrouter.ai	openrouter.ai/keys	One key, dozens of models. Pick anything ending in :free.
Hugging Face	✅ Free tier (rate-limited)	huggingface.co/join	Tokens	Text-only on the free Inference API. Create a Read token.

Paid

Provider	Sign up	Get a key	Notes
Anthropic Claude	console.anthropic.com	Settings → API keys	Strongest reasoning + vision. No free tier.
OpenAI ChatGPT	platform.openai.com	API keys	gpt-4o-mini is the cheapest vision option.
Perplexity	perplexity.ai/settings/api	Same page	Web-grounded answers. No image input.

Tip: All keys are stored locally with chrome.storage.sync. You can switch providers anytime from the settings page (click the extension icon).

---

Configuration

Click the Smartii icon in the toolbar (or use chrome://extensions → Details → Extension options) to open the settings page. You can change:

• Provider and model
• API keys (one per provider, all kept locally)
• Background — solid dark or clear/glass
• Accent color
• Width, corner radius, distance from bottom
• System prompt (advanced)

---

Troubleshooting

The keybind does nothing

Most common cause: Chrome doesn't always assign suggested shortcuts on first install, especially when an extension was reloaded after a manifest fix. Check chrome://extensions/shortcuts — find Smartii, and if the boxes next to "Toggle Smartii" or "Screenshot the page and solve" are empty, click the pencil and press your shortcut to bind it.

If shortcuts are assigned but nothing happens on certain pages: Smartii can't run on chrome://, chrome-extension://, the Web Store, or the New Tab page — Chrome forbids extensions from injecting on those URLs. Try a regular website (e.g. github.com) to verify.

You can also click the Smartii icon in the toolbar to toggle the bar. That uses the same code path as the keybind and works on any page that allows extensions.

"Failed to load extension … invalid value for commands"

That means the manifest.json declares a keyboard shortcut Chrome's commands API doesn't accept. Enter, Tab, Escape and (on Mac) most non-Command/MacCtrl modifiers are rejected even if they're in the default field of a different platform. Make sure you're on the latest release — this was fixed in v1.0.4.

Nothing came back from the model

Open the extension's service-worker console: chrome://extensions → Smartii → Inspect views: service worker. The error from the provider (invalid key, rate limit, model not found) is printed there. The bar also displays it.

How it works

chrome.commands  ─► background.js  ─► content.js (injects bar)
                          │
                          ├─► chrome.tabs.captureVisibleTab  (screenshot)
                          └─► fetch(provider API)            (solve)

• manifest.json — MV3 manifest. Declares the toggle-smartii and solve-now commands plus <all_urls> host permissions for the screenshot.
• background.js — service worker. Owns the keybind handler, the captureVisibleTab screenshot, and the outbound HTTP call.
• content.js + content.css — injected into every page. Builds the floating bar, handles input/output, talks to the background worker.
• options.html + options.js + options.css — settings page with the full provider onboarding flow.
• lib/providers.js — single source of truth for every provider: endpoint, models, vision support, signup/key URLs, and request builder.

No build step. No bundler. Edit a file, reload the extension.

---

Privacy

• Smartii has no backend. Your screenshots and prompts go directly from your browser to whichever AI provider you've configured.
• API keys are stored in chrome.storage.sync (encrypted, synced across your signed-in Chrome profiles).
• The <all_urls> host permission is required by Chrome to (a) inject the bar on the page and (b) screenshot the visible tab. Smartii reads page text only when you invoke it and only sends it to the provider you chose.

---

⚡ Smartii Pro & Godmode

Free Smartii = the bar + screenshot solving + 7 providers, BYO API key. Forever.

Smartii Pro ($4.99/mo) adds:

• Godmode (Alt+Shift+G) — one keybind, no typing needed. Smartii reads the full screen, identifies every question/problem/error on it, and answers them all directly. When the page has fillable fields (quiz inputs, forms), Godmode types the answers straight into them instead of just printing the solution.
• Cloud sync of settings across browsers (planned).
• Priority rollouts of new providers.

Sign up at smartii.app or click Upgrade on the extension's settings page.

Self-hosting the Pro backend

Both the landing site and Pro entitlement check live in this repo and you can run them yourself if you want to fork Smartii.

• Landing site — docs/, deployed to GitHub Pages via .github/workflows/pages.yml. Edit docs/config.js with your Supabase URL + Stripe Pricing Table ID, push, done.
• Backend — supabase/. Migrations + a Stripe webhook Edge Function. Full setup steps in supabase/README.md.
• Extension — fill lib/config.js with your Supabase URL + anon key. With those blank, Godmode is locked behind the Pro gate — but you can flip Settings → "Unlock Godmode locally" to use it on your own device without any backend.

---

Roadmap

• Godmode — auto-solve everything on the screen with one keybind (Pro)
• Streaming responses
• Conversation history per tab
• Region screenshot (drag-to-select)
• Custom keybind in the settings UI (currently chrome://extensions/shortcuts)
• Firefox port

---

Logo & banner

The mascot logo (icons/logo.png) and hero banner (icons/banner.png) are generated. The repo also includes the prompts used to make them in PROMPTS.md — useful if you want to remix the artwork in your own style. The toolbar icons (icon16/32/48/128.png) are produced from logo.png with high-quality bicubic downscaling.

---

License

MIT.