Skip to content

Latest commit

 

History

History
154 lines (110 loc) · 3.55 KB

README.md

File metadata and controls

154 lines (110 loc) · 3.55 KB
Raw

🚀 Numo CLI

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

PyPI version License: MIT Python 3.8+

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
  1. Create virtual environment:
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
  1. 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

🙏 Acknowledgments

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

Made with ❤️ by Furkan Cosgun