harmony-cli 1.4.0

Beautiful CLI for Harmony AI - Advanced AI Assistant by Mergen AI

🌈 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:

pip install harmony-cli

🎯 Quick Start

After installation, simply run:

harmony

Or:

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:

🌈 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

📝 Usage Examples

Basic Chat

$ harmony
🌈 Harmony > Hello! How are you today?
🤖 Hello! I'm doing great, thank you for asking! How can I assist you today?

View Statistics

🌈 Harmony > /stats
📊 Session Statistics:
- Messages sent: 5
- Total tokens: 1,234
- Session duration: 5m 32s

Get Help

🌈 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:

$ 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:

# 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:

🌈 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:

   pip install --upgrade harmony-cli
   

2. Enable debug mode:

   🌈 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 file for details.

🤝 Support

• 📧 Email: [e-mail]
• 🌐 Website: hal-x.ai
• 📚 Documentation: docs.mergen.az
• 🐛 Issues: GitHub 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.