ClimateIQ - Your AI Climate Action Partner
A comprehensive platform that combines IBM watsonx.ai, RAG (Retrieval-Augmented Generation), real-time climate APIs, and an intuitive Streamlit interface to provide personalized climate action recommendations and environmental impact tracking.
- IBM watsonx.ai Integration: Advanced AI models for climate action recommendations
- RAG System: Retrieval-Augmented Generation with climate knowledge base
- Personalized Responses: Tailored advice based on user profile and location
- Fallback Mode: Intelligent responses even when external services are unavailable
- Weather Data: OpenWeatherMap API integration
- Carbon Emissions: Carbon Interface API for footprint calculations
- NASA POWER: Solar and energy resource data
- Climate Trace: Global emissions tracking
- UN SDG & World Bank: Sustainability indicators
- Location-based recommendations
- Lifestyle-specific suggestions
- Budget-conscious solutions
- Impact estimation and tracking
- Personal carbon footprint monitoring
- Progress visualization with interactive charts
- Emission equivalents (trees, gasoline, coal)
- Community leaderboards
- Real-time weather conditions
- Air quality monitoring
- Local climate trends
- Environmental alerts
- Frontend: Streamlit with custom CSS styling
- AI/ML: IBM watsonx.ai, LangChain, ChromaDB
- APIs: Climate APIs (OpenWeather, Carbon Interface, NASA, etc.)
- Data Processing: Pandas, NumPy
- Visualization: Plotly, Matplotlib
- Environment: Python 3.8+, dotenv
- Python 3.8 or higher
- pip package manager
- Internet connection for API access
git clone https://github.com/Nordic116/Climate-Action-Intelligence-Platform.git
cd Climate-Action-Intelligence-Platformpip install -r requirements.txtpython setup_data_dirs.pypython test_installation.pyCreate a .env file in the root directory with your API keys:
# IBM watsonx.ai
IBM_CLOUD_API_KEY=your_ibm_cloud_api_key
WATSONX_PROJECT_ID=your_watsonx_project_id
IBM_CLOUD_URL=https://us-south.ml.cloud.ibm.com
WATSONX_API_KEY=your_watsonx_api_key
# Climate APIs
OPENWEATHER_API_KEY=your_openweather_api_key
CARBON_INTERFACE_API_KEY=your_carbon_interface_api_key
NASA_API_KEY=your_nasa_api_key
# API Base URLs (pre-configured)
CLIMATETRACE_API_BASE=https://api.climatetrace.org/v6
CARBON_INTERFACE_API_BASE=https://www.carboninterface.com/api/v1
NASA_API_BASE=https://power.larc.nasa.gov/api/temporal
OPENWEATHER_API_BASE=https://api.openweathermap.org/data/2.5
UN_SDG_API_BASE=https://unstats.un.org/SDGAPI/v1
WORLD_BANK_API_BASE=https://api.worldbank.org/v2
# Default settings
DEFAULT_OUTPUT_FORMAT=jsonpython run_app.pyThe application will be available at:
- Local: http://localhost:12000
- Network: Available on your local network
- Launch the app using
python run_app.py - Set up your profile in the sidebar:
- Enter your location
- Select lifestyle type
- Choose areas of interest
- Set your budget range
- Click "Generate New Action Plan" for personalized recommendations
- View prioritized actions based on your profile
- See estimated impact and cost savings
- Access supporting information sources
- Monitor your carbon footprint over time
- View emission equivalents (trees planted, gasoline saved)
- Track progress with interactive charts
- Compare with community averages
- View real-time weather conditions
- Check air quality index
- See local climate trends
- Get environmental alerts
- Chat with the AI climate assistant
- Ask questions about sustainability
- Get personalized advice
- Use quick action buttons for common queries
- View community impact leaderboard
- See collective achievements
- Join challenges and initiatives
- Share your progress
The platform includes a comprehensive demo mode that activates when:
- API keys are not configured
- External services are unavailable
- Network connectivity issues occur
Demo mode provides:
- Sample climate data and visualizations
- Pre-built action plans
- Intelligent fallback responses
- Full interface functionality
Climate-Action-Intelligence-Platform/
โโโ backend/
โ โโโ watsonx_integration/ # IBM watsonx.ai integration
โ โโโ rag_system/ # RAG system with ChromaDB
โ โโโ api_handlers/ # Climate API integrations
โ โโโ data_processors/ # Data processing utilities
โโโ frontend/
โ โโโ dashboard/ # Streamlit application
โโโ data/ # Local data storage
โโโ config.py # Configuration settings
โโโ requirements.txt # Python dependencies
โโโ run_app.py # Application launcher
โโโ .env # Environment variables
- IBM watsonx.ai: Sign up at IBM Cloud
- OpenWeatherMap: Get free API key at OpenWeatherMap
- Carbon Interface: Register at Carbon Interface
- NASA POWER: Request access at NASA POWER
- Climate Trace (public API)
- UN SDG API (public API)
- World Bank API (public API)
python run_app.pyThe application is designed for local use but can be deployed to:
- Cloud platforms (AWS, GCP, Azure)
- Container environments (Docker)
- Streamlit Cloud
- Heroku or similar PaaS
- Hyper-Personalized Climate Action Plans - Uses RAG to combine global climate data with local context
- Real-Time Impact Measurement - Tracks and quantifies actual environmental impact
- Community-Driven Solutions - Crowdsources and validates climate solutions
- Economic Incentivization - Connects users with green financing and carbon offset opportunities
- Scalable Implementation - Works for individuals, SMEs, and large organizations
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Application won't start:
- Check Python version (3.8+ required)
- Verify all dependencies are installed:
pip install -r requirements.txt - Ensure port 12000 is available
API errors:
- Verify API keys in
.envfile - Check internet connectivity
- Review API rate limits
- Use demo mode for testing without APIs
Performance issues:
- Clear browser cache
- Restart the application
- Check system resources
- Check the Issues page
- Review the troubleshooting section
- Contact the development team
- IBM watsonx.ai for advanced AI capabilities
- Climate data providers (OpenWeatherMap, NASA, etc.)
- Streamlit for the amazing web framework
- The open-source community for various libraries and tools
Built with โค๏ธ for a sustainable future ๐ฑ
ClimateIQ - Empowering individuals to take meaningful climate action through AI-driven insights and personalized recommendations.