Here is a glimpse of HacxGPT-CLI in action:

• About The Project
  • What is HacxGPT-CLI?
  • HacxGPT Production Models
• Features
• Supported Providers & Models
• Getting Started
  • Prerequisites: API Key
  • Installation
• Configuration
• Usage
• Roadmap
• Star History
• Contributing
• License

HacxGPT-CLI is designed to provide powerful, unrestricted, and seamless AI-driven conversations, pushing the boundaries of what is possible with natural language processing and code generation.

This repository is an open-source command-line interface that makes powerful AI models accessible without heavy censorship. It provides a clean, professional way to interact with multiple AI providers and unlock their full potential through advanced prompting techniques.

What HacxGPT-CLI Provides:

• ✅ Open-source CLI tool for interacting with AI models
• ✅ Access to multiple providers - OpenRouter, Groq, and HacxGPT API
• ✅ Advanced jailbreak prompts that reduce model censorship
• ✅ Multi-provider support with easy switching between services
• ✅ Cross-platform compatibility - Linux, Windows, macOS, Termux
• ✅ Local API key storage - your keys never leave your machine
• ✅ Free to use - just bring your own API keys from providers

What This Repository Is:

• This is a wrapper/interface framework that connects to AI providers
• Uses third-party APIs (OpenRouter, Groq) with enhanced prompting
• Completely open source and auditable - check the code yourself
• Your API keys are stored locally on your machine only
• All requests go directly to your chosen provider, not through our servers

What This Repository Is NOT:

• ❌ This code itself is not a custom AI model
• ❌ Not a paid service - completely free and open source
• ❌ Does not collect or store your data
• ❌ Does not require payment to use the CLI tool

In addition to this free CLI tool, we also offer custom-trained production models running on dedicated infrastructure, accessible via API subscription.

Our Production Offering:

About HacxGPT Production Models:

• ✨ Custom-trained for coding and technical tasks
• 🚀 Extended context capabilities for handling large codebases
• 🔓 Built uncensored - no jailbreak prompts needed
• ⚡ Dedicated infrastructure - consistent performance
• 🎯 Code-optimized - better understanding of complex technical concepts

Access Production Models:

• 🌐 Visit hacxgpt.com to learn more
• 💬 Join Telegram for API access and pricing
• 📧 Contact contact@hacxgpt.com for enterprise

This Open-Source CLI Provides:

• Powerful AI Conversations: Get intelligent and context-aware answers to your queries
• Extensive Model Support: Access to HacxGPT production models, Groq models, and OpenRouter's library of open-source models
• Unrestricted Framework: System prompts engineered to reduce conventional AI limitations
• Easy-to-Use CLI: Clean and simple command-line interface for smooth interaction
• Cross-Platform: Tested and working on Kali Linux, Ubuntu, Windows, macOS, and Termux
• Multi-Provider Support: Seamlessly switch between different AI providers
• Configuration Management: Built-in commands for managing API keys and model selection
• Local Storage: All configuration and API keys stored securely on your machine

HacxGPT-CLI provides a versatile interface for a wide range of models through multiple providers.

Popular Models to Try:

For Coding:

• hacxgpt-lightning (HacxGPT) - Our custom model optimized for code
• mimo-v2-flash (OpenRouter) - another great model for coding.
• kimi-k2-instruct-0905 (Groq) - great for coding.
• devstral-2512 (OpenRouter) - Lastest coding model from Mistral AI

For Reasoning:

• hacxgpt-lightning (HacxGPT) - Our custom model optimized for code
• deepseek-r1t-chimera (OpenRouter) - Advanced reasoning capabilities

Best Fits

• hacxgpt-lightning (HacxGPT) - Our model optimized for code and problem solving.

Follow these steps to get HacxGPT-CLI running on your system.

To use this framework, you must obtain an API key from at least one supported provider. All providers offer free tiers perfect for getting started.

Option 1: OpenRouter (Recommended for Beginners)

1. Visit openrouter.ai/keys
2. Sign up for a free account
3. Generate your API key
4. Access to many powerful free models included

Option 2: Groq (Great for Fast Responses)

1. Visit console.groq.com/keys
2. Create a free account
3. Generate your API key
4. Very generous free tier with fast inference

Option 3: HacxGPT API (Our Production Models)

• Visit hacxgpt.com to learn about our custom models
• Join Telegram for API access and pricing
• Get access to extended context and production-grade models

We provide simple, one-command installation scripts for your convenience.

1. Download the install.bat script from this repository
2. Double-click the file to run it
3. It will automatically clone the repository and install all dependencies

1. Open your terminal
2. Run the following command:

   bash <(curl -s https://raw.githubusercontent.com/HacxGPT-Official/HacxGPT-CLI/main/scripts/install.sh)

   This will download the installer, make it executable, and run it for you.

HacxGPT-CLI uses a centralized providers.json file for managing API endpoints and models. You can easily switch between providers and models using built-in commands or through the setup menu.

1. Launch the tool:

   hacxgpt
   # OR
   python -m hacxgpt.main

2. Select Option [2] to Configure Security Keys

3. Choose your provider and select your preferred model from the interactive list

4. Enter your API key when prompted - it will be stored locally on your machine

While in chat, use these commands to dynamically manage your configuration:

Run the application directly:

hacxgpt
# OR
python -m hacxgpt.main

The first time you run it, you will be prompted to enter your API key. It will be saved locally for future sessions.

• Start with free providers - Use OpenRouter or Groq to try the tool without cost

• Switch models - Use /models to see available options and /model to switch

• Check your config - Use /status to verify your current setup

• Try different providers - Each has strengths; experiment to find what works best

• For production work - Consider HacxGPT API at hacxgpt.com for Best performance.

We are constantly evolving HacxGPT-CLI. Here are some of the technical milestones we are currently targeting:

• Advanced Reasoning Support: Deep-think/reasoning capabilities for complex problem-solving
• Agentic Capabilities: Autonomous tool use and multi-step execution chains
• Web Search Integration: Real-time data retrieval for up-to-date context
• Advanced File Analysis: Native support for processing large datasets and documents
• IDE Integrations: Plugins for VS Code, IntelliJ, and other popular editors
• Conversation Management: Save, load, and resume conversations
• Multi-Modal Support: Image and document analysis capabilities
• Custom Prompt Templates: User-defined system prompts for specific tasks
• Provider Auto-Switching: Automatically switch providers based on task type

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

• 🐛 Bug fixes and testing - Help us catch and fix issues
• 📝 Documentation improvements - Make our docs clearer and more comprehensive
• 🎨 UI/UX enhancements - Improve the CLI user experience
• 🔌 New AI providers - Add support for additional AI services
• 🌐 Translations - Help make HacxGPT-CLI accessible worldwide
• 💡 Feature implementations - Build new capabilities
• 🧪 Testing coverage - Add tests to improve reliability

We are committed to providing a welcoming and inclusive environment. Please:

• Be respectful and constructive in discussions
• Focus on the code and ideas, not individuals
• Help newcomers learn and contribute
• Report issues through proper channels

Distributed under the Personal-Use Only License (PUOL) 1.0. See LICENSE for more information.

Key Points:

• ✅ Free for personal use
• ✅ Open source for learning and contribution
• ✅ Can be forked and modified for personal projects
• ⚠️ Commercial use requires separate licensing

HacxGPT Resources:

• 🌐 Website: hacxgpt.com - Learn about our production models
• 💬 Telegram Community: t.me/HacxGPT - Community support and announcements
• 📧 Email: contact@hacxgpt.com - Direct contact
• 🐙 GitHub Organization: @HacxGPT-Official

Project Resources:

• 📚 Repository: HacxGPT-CLI
• 🐛 Issue Tracker: Report bugs

Need help? Have questions?

Community Support:

• 💬 Telegram: Join our community for help and discussions
• 🐛 Bug Reports: Open an issue on GitHub

Production Support:

• 🌐 For HacxGPT API support: Visit hacxgpt.com
• 📧 For business inquiries: Email contact@hacxgpt.com

This tool is designed for educational and research purposes. Users are responsible for ensuring their use complies with applicable laws and the terms of service of any third-party APIs they access.

Important Notes:

• ⚠️ API Usage: When using third-party providers (OpenRouter, Groq), you are subject to their terms of service and privacy policies
• ⚠️ Data Privacy: Your prompts are sent to the provider you choose - not to us
• ⚠️ API Keys: Store your API keys securely and never share them
• ⚠️ Jailbreak Prompts: System prompts that reduce censorship may violate some providers' terms of service
• ⚠️ Responsibility: You are responsible for how you use this tool

The developers of HacxGPT-CLI:

• Do NOT collect or store your API keys or prompts
• Are NOT responsible for misuse of this software
• Do NOT guarantee the tool will work with all providers indefinitely
• Encourage responsible and legal use of AI technology

This project stands on the shoulders of giants. We thank:

• OpenRouter for providing access to a wide variety of AI models
• Groq for fast inference and generous free tier
• The open-source community for tools, libraries, and inspiration
• All contributors who have helped improve this project
• Our users for feedback, bug reports, and support