# ๐ Harmony CLI
Beautiful command-line interface for **Harmony AI** - Advanced AI Assistant with **Beta Mode** developed by **Mergen AI**.
## โจ Features
- ๐จ **Beautiful Interface** - Rich, colorful terminal UI with rainbow text
- ๐ **Streaming Responses** - Real-time AI responses with smooth animations
- ๐ **Beta Mode** - Advanced v1/responses API with web search capabilities โจ NEW!
- ๐ **Web Search** - Intelligent web search with beautiful animations โจ NEW!
- ๐ ๏ธ **Tool Support** - Enhanced AI with tool integration โจ NEW!
- ๐ฌ **Conversation History** - Keep track of your chat sessions
- ๐ **Session Statistics** - Monitor your usage and performance
- ๐ง **Debug Mode** - Advanced debugging capabilities
- ๐ **Cloud-Powered** - Uses HAL-Harmony-120B model via Mergen AI's infrastructure
## ๐ Installation
Install Harmony CLI using pip:
```bash
pip install harmony-cli
```
## ๐ฏ Quick Start
After installation, simply run:
```bash
harmony
```
Or:
```bash
harmony-cli
```
## ๐ฎ Commands
- `/help` - Show available commands
- `/clear` - Clear conversation history
- `/history` - Show conversation history
- `/stats` - Show session statistics
- `/about` - About Harmony AI and Mergen AI
- `/apikey` - Change API key interactively
- `/server` - Change server URL interactively
- `/debug` - Toggle debug mode
- `/beta` - Toggle beta mode (v1/responses API with tools) โจ NEW!
- `/quit` or `/exit` - Exit the application
## ๐ Beta Mode - NEW!
Experience the future of AI interaction with **Beta Mode**! This advanced mode uses the v1/responses API with enhanced capabilities:
### โจ Beta Mode Features:
- ๐ **Web Search Integration** - AI can search the web for up-to-date information
- ๐ ๏ธ **Tool Support** - Enhanced AI with tool integration capabilities
- ๐จ **Beautiful Animations** - Stunning search animations and visual feedback
- ๐ง **Advanced Reasoning** - More sophisticated response generation
- ๐ **Real-time Data** - Access to current information via web search
### ๐ How to Use Beta Mode:
```bash
๐ Harmony > /beta
๐ Beta Mode Activated!
โจ You're now using the advanced Responses API with:
๐ Web search capabilities
๐ ๏ธ Enhanced tool support
๐ง Improved reasoning
๐ Harmony Beta > Azษrbaycanda hazฤฑrda minimum ษmษkhaqqฤฑ qanuna gรถrษ nษ qษdษrdir?
๐ Searching the web for up-to-date information...
๐ Please wait while I gather the latest data...
```
## ๐ค About Harmony AI
**Harmony AI** is powered by the **HAL-Harmony-120B** model, an advanced AI assistant developed by **Mergen AI**. It's designed for real-world applications and communicates in a clear, intelligent, and highly informative way.
### Key Features:
- ๐ง **Advanced AI Model**: HAL-Harmony-120B
- ๐ **Multilingual**: Trained primarily on Azerbaijani data, supports multiple languages
- ๐ข **Enterprise Ready**: Developed by Mergen AI for professional use
- โก **High Performance**: Optimized for speed and accuracy
- ๐ **Web Search**: Real-time information retrieval (Beta Mode)
## ๐ข About Mergen AI
**Mergen AI** is a leading artificial intelligence company focused on developing cutting-edge AI solutions. We specialize in:
- ๐ค Advanced AI model development
- ๐ AI infrastructure and APIs
- ๐ผ Enterprise AI solutions
- ๐ฌ AI research and innovation
Visit us at: [hal-x.ai](https://hal-x.ai)
## ๐ Usage Examples
### Basic Chat
```bash
$ harmony
๐ Harmony > Hello! How are you today?
๐ค Hello! I'm doing great, thank you for asking! How can I assist you today?
```
### View Statistics
```bash
๐ Harmony > /stats
๐ Session Statistics:
- Messages sent: 5
- Total tokens: 1,234
- Session duration: 5m 32s
```
### Get Help
```bash
๐ Harmony > /help
๐ฎ Available Commands:
- /help - Show this help message
- /clear - Clear conversation history
- /history - Show conversation history
- /stats - Show session statistics
- /about - About Harmony AI and Mergen AI
- /debug - Toggle debug mode
- /quit - Exit the application
```
## ๐ง Configuration
### API Key Setup
Harmony CLI offers **two convenient ways** to set your API key:
#### Option 1: Interactive Input โจ NEW!
Simply run `harmony` and the CLI will prompt you to enter your API key:
```bash
$ harmony
๐ Welcome to Harmony CLI!
๐ Please enter your API key: [hidden input]
โ
API Key Set Successfully!
```
#### Option 2: Environment Variable
Set the environment variable once and never worry about it again:
```bash
# Windows
set HARMONY_API_KEY=your-api-key-here
# Linux/Mac
export HARMONY_API_KEY=your-api-key-here
```
### Change API Key During Session
You can change your API key anytime during a chat session:
```bash
๐ Harmony > /apikey
๐ Change API Key
Current key: hm-w60NQiv...
๐ New API key: [hidden input]
โ
API key updated successfully!
```
## ๐ Troubleshooting
If you encounter any issues:
1. **Update to the latest version**:
```bash
pip install --upgrade harmony-cli
```
2. **Enable debug mode**:
```bash
๐ Harmony > /debug
```
3. **Check your internet connection** - Harmony CLI requires internet access to communicate with our AI servers.
## ๐ License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## ๐ค Support
- ๐ง **Email**: support@mergen.az
- ๐ **Website**: [hal-x.ai](https://hal-x.ai)
- ๐ **Documentation**: [docs.mergen.az](https://docs.mergen.az)
- ๐ **Issues**: [GitHub Issues](https://github.com/mergen-ai/harmony-cli/issues)
## ๐ Contributing
We welcome contributions! Please feel free to submit a Pull Request.
---
**Made with โค๏ธ by Mergen AI**
*Intelligence with everyone. For everyone. For Azerbaijan.*
Raw data
{
"_id": null,
"home_page": "https://github.com/mergen-ai/harmony-cli",
"name": "harmony-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Mergen AI <info@mergen.az>",
"keywords": "ai, cli, harmony, mergen, assistant, chat, artificial-intelligence",
"author": "Mergen AI",
"author_email": "Mergen AI <info@mergen.az>",
"download_url": "https://files.pythonhosted.org/packages/1c/b6/aeb8ae129cda2a98c34d4ce82f564de0dcfd3d50f052e929b8e53c261473/harmony_cli-1.4.0.tar.gz",
"platform": null,
"description": "# \ud83c\udf08 Harmony CLI\r\n\r\nBeautiful command-line interface for **Harmony AI** - Advanced AI Assistant with **Beta Mode** developed by **Mergen AI**.\r\n\r\n\r\n\r\n\r\n\r\n\r\n## \u2728 Features\r\n\r\n- \ud83c\udfa8 **Beautiful Interface** - Rich, colorful terminal UI with rainbow text\r\n- \ud83d\ude80 **Streaming Responses** - Real-time AI responses with smooth animations\r\n- \ud83c\udf1f **Beta Mode** - Advanced v1/responses API with web search capabilities \u2728 NEW!\r\n- \ud83d\udd0d **Web Search** - Intelligent web search with beautiful animations \u2728 NEW!\r\n- \ud83d\udee0\ufe0f **Tool Support** - Enhanced AI with tool integration \u2728 NEW!\r\n- \ud83d\udcac **Conversation History** - Keep track of your chat sessions\r\n- \ud83d\udcca **Session Statistics** - Monitor your usage and performance\r\n- \ud83d\udd27 **Debug Mode** - Advanced debugging capabilities\r\n- \ud83c\udf10 **Cloud-Powered** - Uses HAL-Harmony-120B model via Mergen AI's infrastructure\r\n\r\n## \ud83d\ude80 Installation\r\n\r\nInstall Harmony CLI using pip:\r\n\r\n```bash\r\npip install harmony-cli\r\n```\r\n\r\n## \ud83c\udfaf Quick Start\r\n\r\nAfter installation, simply run:\r\n\r\n```bash\r\nharmony\r\n```\r\n\r\nOr:\r\n\r\n```bash\r\nharmony-cli\r\n```\r\n\r\n## \ud83c\udfae Commands\r\n\r\n- `/help` - Show available commands\r\n- `/clear` - Clear conversation history\r\n- `/history` - Show conversation history\r\n- `/stats` - Show session statistics\r\n- `/about` - About Harmony AI and Mergen AI\r\n- `/apikey` - Change API key interactively\r\n- `/server` - Change server URL interactively\r\n- `/debug` - Toggle debug mode\r\n- `/beta` - Toggle beta mode (v1/responses API with tools) \u2728 NEW!\r\n- `/quit` or `/exit` - Exit the application\r\n\r\n## \ud83c\udf1f Beta Mode - NEW!\r\n\r\nExperience the future of AI interaction with **Beta Mode**! This advanced mode uses the v1/responses API with enhanced capabilities:\r\n\r\n### \u2728 Beta Mode Features:\r\n- \ud83d\udd0d **Web Search Integration** - AI can search the web for up-to-date information\r\n- \ud83d\udee0\ufe0f **Tool Support** - Enhanced AI with tool integration capabilities \r\n- \ud83c\udfa8 **Beautiful Animations** - Stunning search animations and visual feedback\r\n- \ud83e\udde0 **Advanced Reasoning** - More sophisticated response generation\r\n- \ud83c\udf10 **Real-time Data** - Access to current information via web search\r\n\r\n### \ud83d\ude80 How to Use Beta Mode:\r\n```bash\r\n\ud83c\udf08 Harmony > /beta\r\n\ud83d\ude80 Beta Mode Activated!\r\n\u2728 You're now using the advanced Responses API with:\r\n\ud83d\udd0d Web search capabilities\r\n\ud83d\udee0\ufe0f Enhanced tool support\r\n\ud83e\udde0 Improved reasoning\r\n\r\n\ud83c\udf08 Harmony Beta > Az\u0259rbaycanda haz\u0131rda minimum \u0259m\u0259khaqq\u0131 qanuna g\u00f6r\u0259 n\u0259 q\u0259d\u0259rdir?\r\n\ud83c\udf10 Searching the web for up-to-date information...\r\n\ud83d\udd0d Please wait while I gather the latest data...\r\n```\r\n\r\n## \ud83e\udd16 About Harmony AI\r\n\r\n**Harmony AI** is powered by the **HAL-Harmony-120B** model, an advanced AI assistant developed by **Mergen AI**. It's designed for real-world applications and communicates in a clear, intelligent, and highly informative way.\r\n\r\n### Key Features:\r\n- \ud83e\udde0 **Advanced AI Model**: HAL-Harmony-120B\r\n- \ud83c\udf0d **Multilingual**: Trained primarily on Azerbaijani data, supports multiple languages\r\n- \ud83c\udfe2 **Enterprise Ready**: Developed by Mergen AI for professional use\r\n- \u26a1 **High Performance**: Optimized for speed and accuracy\r\n- \ud83d\udd0d **Web Search**: Real-time information retrieval (Beta Mode)\r\n\r\n## \ud83c\udfe2 About Mergen AI\r\n\r\n**Mergen AI** is a leading artificial intelligence company focused on developing cutting-edge AI solutions. We specialize in:\r\n\r\n- \ud83e\udd16 Advanced AI model development\r\n- \ud83c\udf10 AI infrastructure and APIs\r\n- \ud83d\udcbc Enterprise AI solutions\r\n- \ud83d\udd2c AI research and innovation\r\n\r\nVisit us at: [hal-x.ai](https://hal-x.ai)\r\n\r\n## \ud83d\udcdd Usage Examples\r\n\r\n### Basic Chat\r\n```bash\r\n$ harmony\r\n\ud83c\udf08 Harmony > Hello! How are you today?\r\n\ud83e\udd16 Hello! I'm doing great, thank you for asking! How can I assist you today?\r\n```\r\n\r\n### View Statistics\r\n```bash\r\n\ud83c\udf08 Harmony > /stats\r\n\ud83d\udcca Session Statistics:\r\n- Messages sent: 5\r\n- Total tokens: 1,234\r\n- Session duration: 5m 32s\r\n```\r\n\r\n### Get Help\r\n```bash\r\n\ud83c\udf08 Harmony > /help\r\n\ud83c\udfae Available Commands:\r\n- /help - Show this help message\r\n- /clear - Clear conversation history\r\n- /history - Show conversation history\r\n- /stats - Show session statistics\r\n- /about - About Harmony AI and Mergen AI\r\n- /debug - Toggle debug mode\r\n- /quit - Exit the application\r\n```\r\n\r\n## \ud83d\udd27 Configuration\r\n\r\n### API Key Setup\r\n\r\nHarmony CLI offers **two convenient ways** to set your API key:\r\n\r\n#### Option 1: Interactive Input \u2728 NEW!\r\nSimply run `harmony` and the CLI will prompt you to enter your API key:\r\n\r\n```bash\r\n$ harmony\r\n\ud83d\udd11 Welcome to Harmony CLI!\r\n\ud83d\udd11 Please enter your API key: [hidden input]\r\n\u2705 API Key Set Successfully!\r\n```\r\n\r\n#### Option 2: Environment Variable\r\nSet the environment variable once and never worry about it again:\r\n\r\n```bash\r\n# Windows\r\nset HARMONY_API_KEY=your-api-key-here\r\n\r\n# Linux/Mac\r\nexport HARMONY_API_KEY=your-api-key-here\r\n```\r\n\r\n### Change API Key During Session\r\nYou can change your API key anytime during a chat session:\r\n\r\n```bash\r\n\ud83c\udf08 Harmony > /apikey\r\n\ud83d\udd11 Change API Key\r\nCurrent key: hm-w60NQiv...\r\n\ud83d\udd11 New API key: [hidden input]\r\n\u2705 API key updated successfully!\r\n```\r\n\r\n## \ud83d\udc1b Troubleshooting\r\n\r\nIf you encounter any issues:\r\n\r\n1. **Update to the latest version**:\r\n ```bash\r\n pip install --upgrade harmony-cli\r\n ```\r\n\r\n2. **Enable debug mode**:\r\n ```bash\r\n \ud83c\udf08 Harmony > /debug\r\n ```\r\n\r\n3. **Check your internet connection** - Harmony CLI requires internet access to communicate with our AI servers.\r\n\r\n## \ud83d\udcc4 License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n\r\n## \ud83e\udd1d Support\r\n\r\n- \ud83d\udce7 **Email**: support@mergen.az\r\n- \ud83c\udf10 **Website**: [hal-x.ai](https://hal-x.ai)\r\n- \ud83d\udcda **Documentation**: [docs.mergen.az](https://docs.mergen.az)\r\n- \ud83d\udc1b **Issues**: [GitHub Issues](https://github.com/mergen-ai/harmony-cli/issues)\r\n\r\n## \ud83c\udf89 Contributing\r\n\r\nWe welcome contributions! Please feel free to submit a Pull Request.\r\n\r\n---\r\n\r\n**Made with \u2764\ufe0f by Mergen AI**\r\n\r\n*Intelligence with everyone. For everyone. For Azerbaijan.*\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Beautiful CLI for Harmony AI - Advanced AI Assistant by Mergen AI",
"version": "1.4.0",
"project_urls": {
"Bug Reports": "https://github.com/mergen-ai/harmony-cli/issues",
"Documentation": "https://docs.mergen.az/harmony-cli",
"Homepage": "https://hal-x.ai",
"Repository": "https://github.com/mergen-ai/harmony-cli"
},
"split_keywords": [
"ai",
" cli",
" harmony",
" mergen",
" assistant",
" chat",
" artificial-intelligence"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "2b9f8d462af357b3c029a881e6c5e1ca3a7c15e4fd3a169aa2676d528fce8c3f",
"md5": "979db073cee68994caf67ce02235b3f1",
"sha256": "478b497688fba0fd2cc7e956d3dcb272d2b4952648d35176694b5b1da96eda2f"
},
"downloads": -1,
"filename": "harmony_cli-1.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "979db073cee68994caf67ce02235b3f1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 15308,
"upload_time": "2025-08-20T10:37:36",
"upload_time_iso_8601": "2025-08-20T10:37:36.110908Z",
"url": "https://files.pythonhosted.org/packages/2b/9f/8d462af357b3c029a881e6c5e1ca3a7c15e4fd3a169aa2676d528fce8c3f/harmony_cli-1.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "1cb6aeb8ae129cda2a98c34d4ce82f564de0dcfd3d50f052e929b8e53c261473",
"md5": "6728c30728c69f33972fdac8bdf259b9",
"sha256": "08c9321a194fa4406bd148025465852e6b61ed6122428cd078b57278de02df8b"
},
"downloads": -1,
"filename": "harmony_cli-1.4.0.tar.gz",
"has_sig": false,
"md5_digest": "6728c30728c69f33972fdac8bdf259b9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 18336,
"upload_time": "2025-08-20T10:37:38",
"upload_time_iso_8601": "2025-08-20T10:37:38.378996Z",
"url": "https://files.pythonhosted.org/packages/1c/b6/aeb8ae129cda2a98c34d4ce82f564de0dcfd3d50f052e929b8e53c261473/harmony_cli-1.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-20 10:37:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mergen-ai",
"github_project": "harmony-cli",
"github_not_found": true,
"lcname": "harmony-cli"
}
JSON
