Metadata-Version: 2.4
Name: atlas-world-intel
Version: 1.0.0
Summary: World Intelligence CLI - explore countries, economies, currencies and geography from your terminal
Author-email: Khizar Arain <your@email.com>
License-Expression: MIT
Project-URL: Homepage, https://khizar-arain.vercel.app
Project-URL: Repository, https://github.com/khizerarain/atlas
Keywords: cli,world,geography,countries,terminal,atlas
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer[all]>=0.12.0
Requires-Dist: rich>=13.0.0
Requires-Dist: requests>=2.31.0
Requires-Dist: openai>=1.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: thefuzz>=0.22.0
Requires-Dist: pytz>=2024.1
Requires-Dist: pycountry>=23.12.11
Requires-Dist: geopy>=2.4.0
Requires-Dist: forex-python>=1.8
Dynamic: license-file

# ATLAS

## Installation

```bash
pip install atlas-world-intel
```

Then run:

```bash
atlas
```

No cloning required.

ATLAS is a Python command-line experience for exploring the world from your terminal. It combines country data, rankings, currency conversion, travel tips, a geography quiz, and AI-powered explanations into a single polished dashboard.

![ATLAS demo](demo.gif)

> Animated demo placeholder — add a GIF named demo.gif to this folder to replace the placeholder.

## Development

```bash
git clone https://github.com/khizerarain/atlas
cd atlas
pip install -r requirements.txt
cp .env.example .env
# Add your API keys to .env
python -m atlas.main
```

## Commands

| Command | Example | Description |
| --- | --- | --- |
| atlas country | atlas country japan | Show a Rich country profile with key facts |
| atlas compare | atlas compare france germany | Compare two countries side by side |
| atlas top | atlas top population | Show the top 10 countries by population, area, or borders |
| atlas convert | atlas convert 100 USD PKR | Convert currencies using live exchange rates |
| atlas time | atlas time japan | Show the current local time for a country |
| atlas quiz | atlas quiz | Run a 10-question geography quiz |
| atlas learn | atlas learn africa | Show continent-level highlights |
| atlas ask | atlas ask What is the capital of Morocco? | Ask ATLAS AI a geography question |
| atlas travel | atlas travel japan | Show travel tips and emergency info |

## Tech Stack

- Python
- Typer
- Rich
- RestCountries API
- OpenAI
- exchangerate.host

## Environment Variables

- OPENAI_API_KEY: Required for AI answers via the atlas ask command.
- EXCHANGE_API_KEY: Optional for exchange-rate integrations; the default free endpoint is used when it is not present.

## License

[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)
