🚀 Numo CLI

Your Swiss Army Knife for Calculations, Conversions, and Translations in the Terminal!

Numo CLI transforms your terminal into a powerful computational assistant. Whether you need to crunch numbers, convert units, or translate text, Numo CLI has got you covered - all without leaving your command line!

✨ Features

🧮 Smart Calculations

• Basic arithmetic operations
• Complex mathematical expressions
• Scientific calculations
• Support for parentheses and operator precedence

🔄 Universal Converter

• Length (km, m, mi, ft, etc.)
• Mass (kg, g, lb, oz, etc.)
• Currency (Real-time rates for USD, EUR, GBP, etc.)
• And many more!

🌍 Instant Translations

• Support for multiple languages
• Natural language processing
• Instant results

⚡ Powerful CLI

• Interactive shell with command history
• Batch processing for multiple calculations
• Function and variable listing
• User-friendly error messages

🚀 Quick Start

Installation

pip install numo-cli

For macOS/Linux users, add Python's bin directory to your PATH:

echo 'export PATH="$HOME/Library/Python/3.9/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Interactive Mode

Launch the interactive shell:

numo-cli

Direct Commands

# Mathematical Operations
numo-cli "2 * (3 + 4)"          # Output: 14
numo-cli "sqrt(16)"             # Output: 4

# Unit Conversions
numo-cli "5.5 km to miles"      # Output: 3.42 miles
numo-cli "100 usd to eur"       # Output: 91.85 EUR
numo-cli "30 celsius to f"      # Output: 86°F

# Translations
numo-cli "hello world in spanish"  # Output: hola mundo
numo-cli "good morning in japanese" # Output: おはようございます

🎯 Advanced Usage

Available Commands

In interactive mode, try these special commands:

# List all available functions
>>> list functions

# List all available variables
>>> list variables

# Complex calculations
>>> sin(45) + cos(30)
>>> log(1000) / ln(10)

# Chained conversions
>>> 100 km/h to m/s
>>> sum(1,2,3) usd to eur

Batch Processing

Process multiple expressions at once:

numo-cli "1 + 1" "2 * 2" "3 ^ 2"

🛠️ Development Setup

1. Clone and setup:

git clone https://github.com/furkancosgun/numo-cli.git
cd numo-cli

2. Create virtual environment:

python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

3. Install dependencies:

pip install -r requirements.txt
pip install -e .

🤝 Contributing

We love your input! Want to contribute? Here's how:

1. Fork the repo
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

Furkan Cosgun

• GitHub: @furkancosgun
• LinkedIn: Furkan Cosgun

🙏 Acknowledgments

• Built with ❤️ using Numo library
• Special thanks to all contributors

---

Made with ❤️ by Furkan Cosgun