This project is inspired by the official Google Gemini CLI created by the Google Gemini team.
- Repository: https://github.com/google-gemini/gemini-cli
- Author: Google LLC
- License: Apache 2.0
- Purpose: Official CLI tool for interacting with Google's Gemini API
This is NOT a fork of the official repository. Instead, it is:
- A complete rewrite from scratch in Python
- Inspired by the functionality and features of the official CLI
- Designed specifically for Termux on Android
- Built to solve compatibility issues that prevent the official CLI from working on Termux
The official Gemini CLI cannot run on Termux due to:
- Native Dependencies: Requires node-pty, keytar, and other native modules that won't compile on Android
- Platform Detection: Doesn't recognize Android as a valid platform
- Build System: Requires node-gyp and Android NDK which aren't available in Termux
- Authentication: Uses OAuth2 with system keychains not available on Android
- Clipboard: Uses clipboardy which fails to detect Termux correctly
Rather than attempting to patch these fundamental incompatibilities, this project provides a clean, native Python implementation that works perfectly on Termux while maintaining similar functionality.
- For creating the Gemini API and generative AI models
- For the original CLI design and feature set
- For comprehensive API documentation
- For making Gemini accessible to developers
All contributors to the official Gemini CLI repository deserve recognition for their work on the original project.
This project builds upon excellent open-source libraries:
- google-generativeai - Official Google Generative AI Python SDK
- Rich - Beautiful terminal formatting by Will McGugan
- prompt_toolkit - Interactive command lines by Jonathan Slenders
- Pillow - Python Imaging Library
- PyPDF2 - PDF processing
- Termux Community - For making Android development possible
- F-Droid - For distributing Termux and Termux:API
- Android Developers - For the platform we build on
- Open Source Community - For the tools and libraries that make this possible
- Original Gemini CLI: Apache 2.0 License
- This Project: MIT License
Both licenses are permissive open-source licenses. This project does not use any code from the original repository - it's an independent implementation inspired by similar goals.
If you use or reference this project:
Gemini CLI for Termux by Alex72-py
Inspired by the official Google Gemini CLI
https://github.com/Alex72-py/gemini-cli-termux
If you reference the original:
Official Google Gemini CLI
https://github.com/google-gemini/gemini-cli
"Gemini" and "Google Gemini" are trademarks of Google LLC. This project is not affiliated with, endorsed by, or sponsored by Google LLC.
Want to contribute? See CONTRIBUTING.md for guidelines.
Thank you to everyone who makes open-source software possible! 🙏