Key Takeaways
- tgpt (github.com/aandrew-me/tgpt) is a free, open-source, Go-based command-line AI chatbot tool
- Built by a maintainer known by the GitHub handle aandrew-me; repository created April 17, 2023
- License: GPLv3, confirmed via the repository's LICENSE file
- Default mode requires no API key, routing through a free public proxy (opencode.ai's "zen" API) with a shared public key
- Also supports 18+ alternative providers, including bring-your-own-key options for OpenAI, DeepSeek, Groq, and Gemini
- Over 3,200 GitHub stars and 340+ forks; latest release v2.14.0 shipped within the last week of this review
π In One Sentence
tgpt is a free, open-source (GPLv3), Go-based terminal AI tool, built by a maintainer known as aandrew-me since April 2023, that works without a personal API key by default via a free public proxy backend, with over 3,200 GitHub stars and a release shipped within the last week of this review.
π¬ In Plain Terms
tgpt is a free command-line program that lets you chat with an AI, generate shell commands, or write code, without needing to sign up for an API key first β it uses a shared, free backend by default. That free backend is a public proxy service outside the maintainer's direct control, so it can occasionally be rate-limited or break, which is why tgpt also lets you switch to your own API key for OpenAI, Google Gemini, or other providers if you want more reliability.
πNote: This review is based on tgpt's own GitHub repository, its README and in-repo documentation, and its public issue tracker. It does not claim PromptQuorum has run hands-on benchmarks of tgpt.
What Is tgpt?
tgpt is a free, open-source, cross-platform command-line AI chatbot tool written in Go, built by a maintainer known by the GitHub handle aandrew-me. Its own repository tagline describes it as "AI Chatbots in terminal for free."
- Product type: a single-binary command-line tool, cross-platform (Linux, macOS, Windows, FreeBSD)
- Maintainer: aandrew-me (GitHub handle)
- Repository created: April 17, 2023
- License: GNU General Public License v3.0 (GPLv3), confirmed via the repository's LICENSE file
- Scale: over 3,200 GitHub stars and 340+ forks, as of this review, with a release (v2.14.0) shipped within the last week of this check
How Does the "No API Key" Mode Actually Work?
tgpt's default provider, "opencode," routes your prompt through a free public proxy at opencode.ai's "zen" API, using a shared public API key rather than a personal one β that is the entire mechanism behind "no API key needed."
- Default provider: "opencode," using a free model (deepseek-v4-flash-free, per the project's own documentation) via opencode.ai's "zen" API
- No published rate-limit numbers or uptime guarantee exist for this free mode β it is a best-effort public proxy, not a personal, quota-backed account
- tgpt's own public issue tracker documents recurring problems with free backends over the project's history, including rate-limit errors, 429 responses, and 502 gateway errors on various free providers
- To handle this, tgpt includes a
--rotateflag that can automatically try a fallback provider if one fails - Several other keyless free providers are also selectable (
pollinations,powerbrain,isou,koboldai,aihorde), alongside free-with-signup options (groq,gemini) and paid bring-your-own-key options (openai,deepseek,minimax,atlascloud)
What Does tgpt Actually Do?
tgpt offers interactive chat, quick one-shot queries, shell command generation, code-only output, and even basic image generation, all from a single Go binary.
- Interactive chat mode (
-i/--interactive), with multiline support (-m/--multiline) - Quick queries (
-q/--quiet) for one-shot answers without entering interactive mode - Shell command generation (
-s/--shell), similar in spirit to shell-gpt's core feature - Code-only output mode (
-c/--code) - Image generation (
-img/--image), via providers including pollinations, magicstudio, and anyapi, per its own documentation - Interactive web-search find mode and tool-calling (web search, file read/write, grep, glob, exec) plus MCP server integration, per its own source and documentation
- Multi-provider switching via
--provider, including bring-your-own-key options
Platform, Pricing, and Licensing
Platform
- What tgpt states:
- Cross-platform: Linux, macOS, Windows, and FreeBSD, distributed as a single Go binary.
Cost (default mode)
- What tgpt states:
- Free, using a shared public proxy with no personal API key required β no published rate-limit guarantee or SLA.
Cost (alternative modes)
- What tgpt states:
- Bring-your-own-key options for OpenAI, DeepSeek, Groq, Gemini, and others, where you pay that provider directly.
Licensing
- What tgpt states:
- GNU General Public License v3.0 (GPLv3), confirmed via the repository's LICENSE file.
GPLv3 carries copyleft obligations that differ from permissive licenses like MIT or Apache 2.0 β review the license terms directly if you plan to redistribute or build commercial products incorporating tgpt's code.
Install tgpt
tgpt installs free via a shell script, package managers, or Go.
Source | Link |
|---|---|
| GitHub repository (source code, GPLv3) | github.com/aandrew-me/tgpt |
| Install (Linux/macOS) | curl -sSL https://raw.githubusercontent.com/aandrew-me/tgpt/main/install | bash -s /usr/local/bin |
| Install (Homebrew) | brew install tgpt |
| Install (Go) | go install github.com/aandrew-me/tgpt/v2@latest |
| Install (Windows PowerShell) | irm https://raw.githubusercontent.com/aandrew-me/tgpt/refs/heads/main/install-win.ps1 | iex |
Review any install script before piping it to a shell, as with any curl-to-bash install method β check the script contents directly on GitHub first if you want to verify it before running it.
Who Should Use tgpt?
tgpt fits developers who want to try terminal AI immediately without setting up an account or API key first, or who want a simple fallback-capable tool.
What tgpt Is Not Good For
tgpt's default free mode is not a good fit for production or business-critical reliability needs, given its documented rate-limit and gateway-error history.
- Not guaranteed reliable in its default free mode β tgpt's own issue tracker documents repeated rate-limit and gateway errors on free backends over its history
- Not an autonomous coding agent β it generates chat responses, shell commands, and code snippets, not multi-file project changes
- Not free of copyleft obligations β GPLv3 requires derivative works and certain distributions to also be GPLv3-licensed; review the terms before building commercial products on top of it
- Not backed by a company or vendor support β treat it as an independently maintained open-source project
- Not confirmed to have consistent feature parity across every provider β tool-calling and MCP support depend on which backend you select
Common Mistakes When Evaluating tgpt
Most confusion about tgpt comes from outdated claims about its default provider, or misunderstanding how its free mode technically works.
Competitors and Alternatives
tgpt is most often compared to shell-gpt and aichat β its main differentiator is working without any API key or account setup by default.
Tool | Best known for | Link |
|---|---|---|
| shell-gpt | Python CLI focused on shell command generation with a confirmation step | shell-gpt review |
| aichat | Rust CLI with 20+ providers, RAG, and function calling built in | aichat review |
| Aider | Terminal-native, git-centric full AI pair programmer | Aider review |
| GitHub Copilot CLI | GitHub's own terminal AI command assistant (requires a paid subscription) | github.com/features/copilot |
This list reflects tools commonly compared to tgpt, not an independent PromptQuorum ranking β verify each tool's current features and reliability before choosing.
Frequently Asked Questions
What is tgpt?
tgpt (github.com/aandrew-me/tgpt) is a free, open-source (GPLv3), Go-based command-line AI chatbot tool that works without requiring your own API key by default.
How does tgpt work without an API key?
Its default provider, "opencode," routes your prompt through a free public proxy (opencode.ai's "zen" API) using a shared public key rather than a personal account β this is the specific mechanism, not a bypass of any provider's terms.
Is tgpt's free mode reliable?
There is no published rate-limit guarantee or uptime SLA for the default free mode. tgpt's own issue tracker documents repeated rate-limit and gateway errors on free backends over its history, which is why a --rotate fallback flag exists.
Can I use my own API key with tgpt?
Yes, tgpt supports bring-your-own-key options for providers including OpenAI, DeepSeek, Groq, and Gemini, via the --provider flag.
Who maintains tgpt?
A developer known by the GitHub handle aandrew-me, with the repository created April 17, 2023.
What license is tgpt released under?
GNU General Public License v3.0 (GPLv3), confirmed via the repository's LICENSE file.
Does tgpt generate shell commands like shell-gpt?
Yes, tgpt's -s/--shell flag generates OS-aware shell commands from natural-language requests, similar in spirit to shell-gpt's core feature.
Does tgpt support image generation?
Yes, via its -img/--image flag, using providers including pollinations, magicstudio, and anyapi, per its own documentation.
Is tgpt an autonomous coding agent?
No, tgpt generates chat responses, shell commands, and code snippets β it does not perform multi-file, autonomous project changes.
Has PromptQuorum independently tested tgpt's claims?
This review is based on tgpt's own GitHub repository, its README, its in-repo documentation, and its public issue tracker, rather than hands-on benchmarking by PromptQuorum.