BATHORY is the world's most comprehensive government procurement analytics platform, analyzing 2.93 million Mexican government contracts from 2003-2024, totaling over 13ドル.0 trillion MXN in procurement spending. Following our successful 2023-2024 integration (+309,801 contracts), the platform provides advanced fraud detection, market intelligence, and transparency tools with unprecedented post-COVID recovery insights.

• 🌍 Global Leadership: Largest government procurement database worldwide
• 📈 Post-COVID Recovery: 18.5% value increase in 2023-2024 vs pre-pandemic
• 🎯 A-Grade Quality: 92.8% data completion through advanced processing
• 🤖 Advanced Analytics: Complete institutional hierarchy + ML categorization
• 🚨 Fraud Detection: 30+ indicators with production-ready capabilities
• 📊 Research Ready: Top 100 statistical analyses across all categories
• 🏛️ Expert Validated: Committee-approved for government deployment

# Clone the repository
git clone https://github.com/your-username/bathory.git
cd bathory
# Install dependencies
pip install -r requirements.txt
# Download database (see data/DATABASE_ACCESS.md)
# Place bathory_production.db in data/ folder

# Import BATHORY analytics
from bathory import BathoryAnalytics
# Initialize platform
analytics = BathoryAnalytics()
# Basic analysis
suppliers = analytics.top_suppliers(limit=100)
institutions = analytics.top_institutions(limit=100)
trends = analytics.covid_recovery_analysis(years=[2023, 2024])
# Generate visualizations
analytics.create_timeline_chart()
analytics.create_hierarchy_heatmap()

# Run pre-built analyses
python scripts/generate_analyses.py
# Create visualizations
python scripts/create_visualizations.py
# Check data quality
python scripts/data_quality_check.py

• Institutional Hierarchy: Complete federal/state/municipal classification
• Contract Categorization: 24 procurement categories with ML validation
• Market Intelligence: Comprehensive supplier ecosystem analysis
• Trend Analysis: Post-COVID recovery patterns and seasonal insights

• 30+ Risk Indicators: Advanced pattern recognition system
• Network Analysis: Vendor relationship intelligence
• Anomaly Detection: Statistical outlier identification
• Investigation Tools: Priority case flagging for law enforcement

• Market Concentration: Competition analysis and monopoly detection
• Price Intelligence: Historical cost trends and benchmarking
• Economic Impact: GDP analysis and employment estimates
• Policy Insights: Data-driven government decision support

• Recovery Metrics: 18.5% value increase in 2023-2024
• Market Adaptation: Vendor diversification and institutional changes
• Policy Response: Government procurement modernization tracking
• Economic Resilience: Sectoral recovery pattern analysis

• 📥 Installation Guide - Complete setup instructions
• 🚀 Quick Start Tutorial - Get running in 5 minutes
• 📊 Data Schema Guide - Complete database documentation
• 🔧 API Reference - Technical integration guide

• 📖 200-Page Expert Analysis - Complete findings report
• 📈 2023-2024 Integration Summary - Latest achievements
• 🏛️ Technical Implementation - WAR PIGS methodology
• 🌍 Global Deployment Guide - International implementation

• 🔬 Research Guide - Academic partnership toolkit
• 🏛️ Government Integration - Official adoption guide
• 📊 Top 100 Analyses - Complete statistical intelligence
• 🎨 Visualizations - Professional graphics suite

• Procurement Oversight: Real-time monitoring and compliance
• Fraud Investigation: Advanced detection and case development
• Policy Analysis: Evidence-based decision making
• Transparency Reporting: Public accountability metrics

• Economic Research: Government spending pattern analysis
• Social Science: Public policy impact studies
• Data Science: Advanced analytics and ML research
• Comparative Studies: International procurement analysis

• Investigative Reporting: Data-driven story development
• Public Interest: Government accountability coverage
• Market Analysis: Economic impact reporting
• Transparency Advocacy: Democratic oversight support

• Development Partners: Transparency capacity building
• Anti-Corruption: Global best practices implementation
• Academic Collaboration: Research partnership development
• Technology Transfer: Platform deployment in other countries

• Transparency Leadership: Mexico sets global standard
• Academic Excellence: World-class research platform
• Democratic Innovation: Citizen oversight enhancement
• Economic Intelligence: Market transparency advancement

• 13ドル.0 Trillion MXN Analyzed: Complete financial transparency
• 75+ Countries Targeted: Global deployment potential
• 150+ Universities: Academic partnership opportunities
• 50+ Government Agencies: Collaboration framework ready

We welcome contributions from the global transparency community!

• 🐛 Issue Reporting: Help identify bugs and improvements
• 💡 Feature Development: Contribute new analytical capabilities
• 📖 Documentation: Improve guides and examples
• 🧪 Testing: Add validation and quality assurance
• 🌐 Translation: Support multilingual accessibility
• 🏛️ Government Adoption: Facilitate official deployment

# Fork the repository
git clone https://github.com/your-username/bathory.git
cd bathory
# Create development environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install development dependencies
pip install -r requirements-dev.txt
# Run tests
python -m pytest tests/
# Run quality checks
python scripts/data_quality_check.py

See CONTRIBUTING.md for detailed guidelines.

This project is licensed under the MIT License - see LICENSE for details.

@software{bathory2025,
 title={BATHORY: Mexican Government Procurement Analytics Platform},
 author={BATHORY Development Team},
 year={2025},
 url={https://github.com/your-username/bathory},
 note={World's most comprehensive government procurement database - 2.93M contracts}
}

• Mexican Government: Data transparency and open government initiatives
• Expert Committee: 6-member multidisciplinary validation team
• Academic Partners: Research methodology and validation support
• Open Source Community: Tools, libraries, and collaborative development
• International Organizations: Transparency and anti-corruption support

• GitHub Issues: Report bugs and request features
• Discussions: Community Q&A and collaboration
• Email: bathory-support@transparency.org

• Institutional Collaboration: partnerships@bathory-analytics.org
• Research Partnerships: research@bathory-analytics.org
• International Deployment: global@bathory-analytics.org