v0.1.3 · MIT License

AI assistant for
your terminal

Coding help, pentesting, SOC analysis — powered by any AI provider. Bring your own keys. Works offline with Ollama.

Install now GitHub →
$ pipx install franki-cli

What it does

Everything in one command

franki lives in your terminal, talks to multiple AI providers, and falls back automatically when one hits a rate limit.

Multi-provider routing

Groq, Gemini, OpenRouter, Anthropic, Ollama, Mistral, Cerebras, Cohere, Together, Azure and more. Automatic fallback when rate-limited.

🔧

Agentic tool use

Reads, writes, and edits files. Runs shell commands. Searches the web. Applies patches. All with your approval.

🔐

Security skills

Switch to /skill pentest, /skill soc, or /skill security for MITRE mapping, payload generation, CEH/OSCP prep, and alert triage.

💻

Works offline

Point it at a local Ollama instance. No API key needed. Type /ollama to pick a model from what's installed.

🌐

Auto web search

Automatically fetches live results when your message contains latest, CVE-, or news. Powered by Tavily or DuckDuckGo.

📁

Context injection

Use @file.py, @src/, or @git to inject files, directories, or git state directly into your message.

🧠

Long-term memory

Remembers facts, your pentest scope, and notes across sessions with /remember and /memories.

🔌

MCP server support

Connect any MCP-compatible tool server. Manage connections with /mcp and they become part of the agent's toolset.

franki — ~/myproject
● [coding] · groq/llama-3.3-70b-versatile
> @src/api.py fix the auth middleware, it's not checking token expiry

[1/3] ◦ reading src/api.py
[2/3] ◦ reading src/auth.py
[3/3] ◦ editing src/api.py

Fixed — added expiry check in verify_token(). The token payload's exp field was never compared against datetime.utcnow(). Also updated the 401 response to distinguish expired vs invalid tokens.

> /skill pentest
● [pentest] · groq/llama-3.3-70b-versatile

> /mitre credential dumping via lsass
T1003.001 — OS Credential Dumping: LSASS Memory. Tools: Mimikatz, ProcDump, Taskmgr...

Explore

Everything in one place

franki is fully documented, from a one-minute install to deep internals for contributors.

Get started

Install franki in 3 steps with pipx. Add your API keys, run the setup wizard, and start chatting. Works with free-tier providers — no credit card needed.

Install guide →
🔌

AI Providers

11 providers supported — Groq, Gemini, OpenRouter, Ollama, Anthropic, Mistral, Cerebras, Together AI, Cohere, Azure, and any custom OpenAI-compatible endpoint. Automatic fallback when one hits a rate limit.

Browse providers →
📖

Command reference

Every slash command documented — conversation flow, agent tools, skills, long-term memory, security tools, session branching, MCP servers, one-shot CLI and more.

View docs →
🛠

Developer guide

Full architectural overview, the 10-step request lifecycle, routing internals, and step-by-step recipes for adding providers, slash commands, skills, and agent tools.

Read the guide →