v1.0.1

Security & Code Quality Fixes

Fixes

• Cache thread safety: add threading.Lock to all cache read/write/clear operations
• Entrypoint security: replace unsafe . /app/.env sourcing with safe line-by-line KEY=VALUE parser to prevent shell injection
• Unused parameters: remove unused languages and model_size params from _validate_input
• Typo: Excute → Execute in comment

Documentation

• Remove Chinese section and language selector from README
• Remove duplicate # GeoParser API title

Chores

• Delete REVIEW_REPORT.md
• Rewrite commit history to follow Conventional Commits specification

v1.0.0

v1.0.0 - Initial Release

First stable release of the GeoParser API service.

Features

• Geographic entity extraction: extract and disambiguate locations (cities, countries, etc.) from text using SpaCy NER models
• Multi-language support: 24 languages with configurable SpaCy model sizes (sm, md, lg, trf)
• Transformer-based embeddings: uses Hugging Face transformer models for enhanced accuracy
• GeoNames integration: gazetteer-based disambiguation with rich location metadata (coordinates, population, admin regions)
• Batch processing: parse multiple texts in a single API call
• In-memory caching: cache parsed results to improve response times
• Docker deployment: fully containerized with Docker Compose, including health checks and resource limits
• GPU support: optional NVIDIA GPU acceleration via override compose file

API Endpoints

• POST /api/parse - parse single text for geographic entities
• POST /api/parse/batch - batch parse multiple texts
• GET /api/info - service and model information
• GET /api/health - health check
• POST /api/cache/clear - clear cache
• GET /api/languages - list supported languages and model sizes

Tech Stack

• Python, Flask, Gunicorn
• SpaCy, Hugging Face Transformers, PyTorch
• Docker, Docker Compose