# anonymousproo/ip-tracker architecture

> Architecture diagram of the GitHub repository anonymousproo/ip-tracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anonymousproo/ip-tracker
- Repository: https://github.com/anonymousproo/ip-tracker

## Overview

IP-Tracker is a command-line IP lookup tool: it displays the caller’s public IP, accepts target IPs until the user exits, queries external geolocation services, and prints location and network details. The single script owns the requests, response parsing, branching, and presentation; the graph separates these responsibilities for clarity, not because they are separate modules. The README documents ip-api, while the sampled script also calls ipstack. No other runtime source files are listed.

Main entry points: [`IP-Tracker.py`](https://github.com/anonymousproo/ip-tracker/blob/main/IP-Tracker.py) (Target lookup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["CLI interaction"]
  node_cli["Lookup prompt<br/>[IP-Tracker.py]"]
  node_public_ip["Public IP display<br/>[IP-Tracker.py]"]
end

subgraph group_lookup["IP lookup"]
  node_lookup_flow["Target lookup<br/>[IP-Tracker.py]"]
  node_ip_api{{"ip-api service"}}
  node_ipstack{{"ipstack service"}}
  node_results["Details and errors<br/>[IP-Tracker.py]"]
end

node_user(("CLI user"))

node_user -->|"enters target"| node_cli
node_cli -->|"displays startup lookup"| node_public_ip
node_cli -->|"dispatches input"| node_lookup_flow
node_lookup_flow -->|"requests IP data"| node_ip_api
node_lookup_flow -->|"requests geolocation"| node_ipstack
node_lookup_flow -->|"prints parsed details"| node_results
node_ip_api -->|"returns public IP"| node_public_ip
node_ip_api -->|"returns target status"| node_lookup_flow
node_ipstack -->|"returns location data"| node_lookup_flow

click node_cli "https://github.com/anonymousproo/ip-tracker/blob/main/IP-Tracker.py"
click node_public_ip "https://github.com/anonymousproo/ip-tracker/blob/main/IP-Tracker.py"
click node_lookup_flow "https://github.com/anonymousproo/ip-tracker/blob/main/IP-Tracker.py"
click node_results "https://github.com/anonymousproo/ip-tracker/blob/main/IP-Tracker.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_public_ip,node_user toneBlue
class node_lookup_flow,node_ip_api,node_ipstack,node_results toneAmber
```

## Components

### CLI interaction

- [Lookup prompt](https://github.com/anonymousproo/ip-tracker/blob/main/IP-Tracker.py): `IP-Tracker.py`
- [Public IP display](https://github.com/anonymousproo/ip-tracker/blob/main/IP-Tracker.py): `IP-Tracker.py`

### IP lookup

- [Target lookup](https://github.com/anonymousproo/ip-tracker/blob/main/IP-Tracker.py): `IP-Tracker.py`
- **ip-api service**
- **ipstack service**
- [Details and errors](https://github.com/anonymousproo/ip-tracker/blob/main/IP-Tracker.py): `IP-Tracker.py`

### Other components

- **CLI user**

## Connections

- CLI user → Lookup prompt: enters target (evidence: `IP-Tracker.py`)
- Lookup prompt → Public IP display: displays startup lookup (evidence: `IP-Tracker.py`)
- Lookup prompt → Target lookup: dispatches input (evidence: `IP-Tracker.py`)
- Target lookup → ip-api service: requests IP data (evidence: `IP-Tracker.py`)
- Target lookup → ipstack service: requests geolocation (evidence: `IP-Tracker.py`)
- Target lookup → Details and errors: prints parsed details (evidence: `IP-Tracker.py`)
- ip-api service → Public IP display: returns public IP (evidence: `IP-Tracker.py`)
- ip-api service → Target lookup: returns target status (evidence: `IP-Tracker.py`)
- ipstack service → Target lookup: returns location data (evidence: `IP-Tracker.py`)
