ATLAS
Installation
pip install atlas-world-intel
Then run:
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.
Animated demo placeholder — add a GIF named demo.gif to this folder to replace the placeholder.
Development
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
1 maintainer
Metadata
1 maintainer
Release files for atlas-world-intel 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| atlas_world_intel-1.0.0.tar.gz | 18.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| atlas_world_intel-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 41.0 kB
Release files / atlas_world_intel-1.0.0.tar.gz
| Download URL | atlas_world_intel-1.0.0.tar.gz |
|---|---|
| Size | 18.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
40fb8588681d3fcd6f7de68debca180560aa5537ad866cfcee6a0f493566dbc6
|
|
BLAKE2b-256 checksum How to use checksums |
de5ba419eed84cf15cbd999956159e4c78fb7dcc1fea54b790dcdf4cbf87eac7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
Release files / atlas_world_intel-1.0.0-py3-none-any.whl
| Download URL | atlas_world_intel-1.0.0-py3-none-any.whl |
|---|---|
| Size | 22.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
70a9fa92b87c33976e6835aacdd10c08f78cce28cdc5f1d6dde6c5969dfbaf87
|
|
BLAKE2b-256 checksum How to use checksums |
9e543583b9f52e218413f6d14ae9f15779e0dbc862cfbced3f08d3dfcfccffd2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
