Skip to content

impriyanshusah/Currency-converter-python

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

💱 Currency Converter CLI (Python)

A simple Command Line Interface (CLI) app built with Python that converts currencies in real-time using the FreeCurrencyAPI.


✨ Features

  • Convert between world currencies 🌍
  • Real-time exchange rates powered by FreeCurrencyAPI
  • Lightweight & beginner-friendly
  • Secure API key management with .env

🚀 Getting Started

Follow these steps to set up and run the project on your local machine:

1️⃣ Clone the repository

git clone https://github.com/impriyanshusah/Currency-converter-python.git
cd Currency-converter-python

2️⃣ Create a Virtual Environment

It’s recommended to use a virtual environment to keep dependencies isolated.

On Linux/macOS:

python3 -m venv .venv
source .venv/bin/activate

3️⃣ Install Dependencies

pip install -r requirements.txt

4️⃣ Get Your Free API Key

Go to FreeCurrencyAPI

Sign up (it’s free!)

Copy your API key from the Dashboard

5️⃣ Set Up Environment Variables

Create a .env file in the project root and add your API key

6️⃣ Run the App

python3 main.py

🖥️ Usage Example

Here are some currencies - EUR, USD, INR, JPY, RUB, AUD, CAD, GBP
Base currency (e.g., USD, or 'q' to quit): jpy
Target currency: inr
Amount: 5000
5000.00 JPY ≈ 2961.13 INR

Deactivate the virtual environment

You can deactivate venv

deactivate

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages