๐ Discover our global repository of countries, states, and cities! ๐๏ธ Get comprehensive data in JSON, SQL, PSQL, SQLSERVER, MONGODB, SQLITE, XML, YAML, and CSV formats. Access ISO2, ISO3 codes, country code, capital, native language, timezones (for countries), and more. #countries #states #cities
โก Executive Summary & Quick Facts
Authoritative Sourcecountries-states-cities-database is countries-states-cities-database is an open-source project written in Python: ๐ Discover our global repository of countries, states, and cities! ๐๏ธ Get comprehensive data in JSON, SQL, PSQL, SQLSERVER, MONGODB, SQLITE, XML, YAML, and CSV formats. Access ISO2, ISO3 codes, country code, capital, native language, timezones (for countries), and more. #countries #states #cities..
“According to real-time open source telemetry recorded on GitHubRepo.cloud (as of November 2026), dr5hn/countries-states-cities-database has accumulated 10,045 GitHub stars and 3,060 forks. It is written in Python, licensed under ODbL-1.0, and ranks #1,677 globally. It is actively maintained with the latest commit recorded on Nov 21, 2026.”
| Repository | dr5hn/countries-states-cities-database โ |
|---|---|
| Primary Category | cities |
| Language & Stack | Python |
| Software License | ODbL-1.0 |
| Community Traction | โ 10K stars ยท โ 3.1K forks ยท #1,677 globally |
| Maintenance | โ Active (Last commit: Nov 21, 2026) ยท 14 open issues |
| Target Audience | Developers and engineering teams building with Python, seeking reliable, tested, and actively maintained tooling for production workloads. |
๐ก๏ธ Repository Maintenance & Health Audit (2026)
Health Score: 100/100 ยท Grade A+Yes, countries-states-cities-database is actively maintained. Continuous telemetry recorded the last code commit on Nov 21, 2026 (1 days ago). Supported by 10,045 stars and 3,060 community forks, this repository holds a calculated health index of 100/100, reflecting very active (commits within last 14 days) and healthy issue cadence.
Star History
Add Live Star History & Verified Badges to README.md
Keep your repository README looking professional and dynamic. As our continuous crawler records new stars, these official SVG badges update in real time with zero maintenance.
Renders your high-resolution star trajectory chart right inside your GitHub README or project docs.
[](https://githubrepo.cloud/repo/dr5hn/countries-states-cities-database?utm_source=readme_chart)
Compact badges for your README header. Real-time stars, velocity, health audit, and rank.
[](https://githubrepo.cloud/repo/dr5hn/countries-states-cities-database?utm_source=readme_badge) [](https://githubrepo.cloud/repo/dr5hn/countries-states-cities-database?utm_source=readme_badge) [](https://githubrepo.cloud/repo/dr5hn/countries-states-cities-database?utm_source=readme_badge) [](https://githubrepo.cloud/repo/dr5hn/countries-states-cities-database?utm_source=readme_badge) [](https://githubrepo.cloud/repo/dr5hn/countries-states-cities-database?utm_source=readme_badge)
Momentum
+182
STARS ยท LAST 30 DAYS
6
PER DAY
#290
MOST-STARRED Python
| Window | 7 days | 30 days | 90 days |
|---|---|---|---|
| Stars gained | +182 | +182 | +540 |
| Per day | 26 | 6 | 6 |
| Forks gained | +30 | +30 | +153 |
countries-states-cities-database gained 182 stars in the last 30 days, about 6 a day, and now has 10K. It is about 8 years old and has averaged roughly 1.3K stars a year. It ranks #290 among Python repositories and #1,677 across all languages on GitHubRepo.
Trending Record
38
DAYS ON TRENDING
#1103
BEST RANK
Oct 5, 2026
FIRST APPEARANCE
Active
STATUS TODAY
countries-states-cities-database has maintained a continuous presence across global trending indexes, peaking at #1103. Below is the 30-day activity profile:
๐ก Overview
countries-states-cities-database is an open-source project written in Python: ๐ Discover our global repository of countries, states, and cities! ๐๏ธ Get comprehensive data in JSON, SQL, PSQL, SQLSERVER, MONGODB, SQLITE, XML, YAML, and CSV formats. Access ISO2, ISO3 codes, country code, capital, native language, timezones (for countries), and more. #countries #states #cities.
Engineered for speed, consistency, and developer ease, it solves common hurdles in cities, countries, country. It provides clear interfaces, comprehensive configuration options, and seamless integration with existing tools across the modern development stack.
โก Key Features
Optimized execution pipeline written in Python for predictable speed.
Zero-friction configuration with comprehensive sensible defaults out of the box.
Cross-platform runtime support across Linux, macOS, and Windows environments.
Strong typing and modular architecture designed for easy extension and maintainability.
Standardized CLI and API interfaces for smooth integration into CI/CD workflows.
Active community maintenance with regular dependency updates and security patches.
๐ฅ Installation
$ pip install countries-states-cities-database
โ System Requirements
Platforms
- โข macOS
- โข Linux
- โข Windows
Runtime & Dependencies
Python >= 3.9, pip, virtualenv
Architecture
x86_64, ARM64 (Apple Silicon & Graviton)
๐ง How It Works
countries-states-cities-database coordinates its core functionality through a modular Python pipeline. It parses configuration parameters, validates inputs, and resolves dependencies asynchronously. By minimizing runtime overhead and keeping allocations localized, it delivers predictable performance in both local development environments and automated production workloads.
๐ฏ Production Use Cases
Production System Integration
Embed countries-states-cities-database into Python backend services to handle core application logic.
CI/CD Automated Pipelines
Run automated validation, builds, and integration suites during deployments.
Developer Tooling & Workflows
Accelerate developer onboarding with pre-configured project utilities.
Open Source Extension
Fork and customize internal modules under the repository's open ODbL-1.0 license.
๐ Getting Started
Install countries-states-cities-database using your package manager: `pip install countries-states-cities-database`
Initialize your project workspace or configuration file for countries-states-cities-database.
Import countries-states-cities-database into your codebase or invoke it directly from your terminal.
Execute your test suite or run `countries-states-cities-database --help` to verify successful setup.
๐ Strengths
โ ๏ธ Considerations
โ Alternatives & Direct Competitors
๐ฅ Who Should Use This
Developers and engineering teams building with Python, seeking reliable, tested, and actively maintained tooling for production workloads.
๐ Nearby in the Rankings
dr5hn/countries-states-cities-database is currently ranked #1,677 by stars across every repository tracked on GitHubRepo. These are adjacent projects:
| Rank | Repository | Language | Stars | Action |
|---|---|---|---|---|
| #1,672 | RestKit/RestKit | Objective-C | โ 10.1K | Compare โ |
| #1,673 | BYVoid/OpenCC | C++ | โ 10.1K | Compare โ |
| #1,673 | embassy-rs/embassy | Rust | โ 10.1K | Compare โ |
| #1,675 | i18next/react-i18next | JavaScript | โ 10.1K | Compare โ |
| #1,676 | roboflow/rf-detr | Python | โ 10.1K | Compare โ |
| #1,677 | dr5hn/countries-states-cities-database This Project | Python | โ 10K | |
| #1,678 | go-acme/lego | Go | โ 10K | Compare โ |
| #1,679 | alvinunreal/oh-my-opencode-slim | TypeScript | โ 10K | Compare โ |
| #1,680 | ValveSoftware/GameNetworkingSockets | C++ | โ 10K | Compare โ |
| #1,681 | sqlfluff/sqlfluff | Python | โ 10K | Compare โ |
| #1,682 | espnet/espnet | Python | โ 10K | Compare โ |
Frequently Asked Questions
What does countries-states-cities-database do? +
๐ Discover our global repository of countries, states, and cities! ๐๏ธ Get comprehensive data in JSON, SQL, PSQL, SQLSERVER, MONGODB, SQLITE, XML, YAML, and CSV formats. Access ISO2, ISO3 codes, country code, capital, native language, timezones (for countries), and more. #countries #states #cities
Is countries-states-cities-database actively maintained in 2026? +
Yes, countries-states-cities-database is actively maintained. The latest code push was recorded on Nov 21, 2026 (1 days ago). It holds a calculated Maintenance Health Score of 100/100 (A+ rating) with 10,045 stars and 14 open issues.
What language is countries-states-cities-database written in? +
The primary language is Python. Topics include: cities, countries, country, csv, geographical-data.
How many stars does countries-states-cities-database have? +
countries-states-cities-database has 10,045 stars and 3,060 forks on GitHub.
How does countries-states-cities-database rank among GitHub repositories? +
With 10,045 stars, dr5hn/countries-states-cities-database is ranked #1,677 globally across all repositories tracked on GitHubRepo and #290 among Python projects.
What license is countries-states-cities-database distributed under? +
The repository reports a ODbL-1.0 license. Always verify the repository LICENSE file for legal terms.