exchangecli

@github

exchangeCLI: Your Terminal-Based Currency Converter

In our globalized world, staying updated with the latest exchange rates is crucial. exchangecli emerges as a nifty tool designed to make currency conversion as straightforward as typing a command. It's built for speed, efficiency, and ease of use, appealing to anyone who prefers working within a CLI environment over navigating websites or apps.

Getting Started

Setting up exchangecli is a breeze. All you need is an API key from Open Exchange Rates, which you can easily obtain and then place inside a config.py file. This minimal setup ensures that you're always working with the most current data without bogging down your workflow with unnecessary steps.

How to Use exchangecli

exchangecli is designed to be intuitive for anyone familiar with the command line. To convert currencies, simply invoke the rates.py script from your terminal, specifying your base and target currencies as arguments. For example, to find out how much one US Dollar (USD) is worth in Zimbabwean Dollars (ZWL), you'd run:

python src/rates.py --base USD --target ZWL

This command quickly fetches and displays the current exchange rate, making it an invaluable tool for financial analysis, travel planning, or just satisfying your curiosity.

Features and Benefits

  • Speed and Simplicity: Get currency conversion rates quickly without leaving your terminal.
  • Up-to-Date Information: Leverages the Open Exchange Rates API for real-time data.
  • Customizable: Easily change your base and target currencies to fit your needs.

Future Directions

As exchangecli continues to evolve, potential enhancements include adding support for more currencies, implementing more complex financial calculations, and improving user configuration options for a more personalized experience.

Join the Community

exchangecli is open to contributions and feedback from the community. Whether you're a seasoned developer looking to add features or a user with suggestions for improvement, your input is welcome. Together, we can make exchangecli an even more robust and versatile tool for currency conversion.


exchangecli represents a blend of utility and simplicity, embodying the spirit of CLI tools that prioritize functionality and user efficiency. It's more than just a project; it's a testament to the power of open-source collaboration and the continuous quest for better tools in our daily lives and professional endeavors.