Spaces:
Running
Running
| title: Geoai Coding Agent | |
| emoji: 🌍 | |
| colorFrom: pink | |
| colorTo: red | |
| sdk: gradio | |
| sdk_version: 6.3.0 | |
| app_file: app.py | |
| pinned: false | |
| license: agpl-3.0 | |
| tags: | |
| - geospatial | |
| - geospatial-ai | |
| - AI | |
| - ML | |
| - DL | |
| - LLM | |
| - satellite-data | |
| - earth-observation | |
| - nlp | |
| - maps | |
| - data-visualization | |
| - natural-language | |
| - gradio | |
| - huggingface | |
| short_description: GeoAI Coding Agent - Geospatial AI Coding Assistant" | |
| # 🌍 GeoAI Coding Agent | |
| A **Geospatial AI Coding Assistant** powered by `Qwen/Qwen2.5-Coder-7B-Instruct` via HuggingFace Inference API. | |
| Specialized in **GDAL/OGR**, **Rasterio**, **GeoPandas**, **xarray**, and geospatial development across multiple programming languages. | |
|  | |
|  | |
|  | |
| ## ✨ Features | |
| - **🗺️ Geospatial Expertise**: Deep knowledge of GDAL, Rasterio, GeoPandas, PyProj, xarray, and rioxarray | |
| - **💻 Multi-Language Support**: Python, Java, C/C++, JavaScript, TypeScript, Rust | |
| - **📥 Download Options**: Export responses as Markdown, Jupyter Notebooks, or code files | |
| - **🎨 Code Editor Style UI**: Syntax highlighting with dark theme | |
| - **🔒 BYOT (Bring Your Own Token)**: Uses your HuggingFace API token for inference | |
| - **⚡ Streaming Responses**: Real-time token streaming for better UX | |
| ## 🚀 Quick Start | |
| ### Local Development | |
| 1. **Clone the repository** | |
| ```bash | |
| git clone https://github.com/rifatSDAS/geoai-coding-agent.git | |
| cd geoai-coding-agent | |
| ``` | |
| 2. **Create virtual environment** | |
| ```bash | |
| python -m venv venv | |
| source venv/bin/activate # Linux/Mac | |
| # or | |
| venv\Scripts\activate # Windows | |
| ``` | |
| 3. **Install dependencies** | |
| ```bash | |
| pip install -r requirements.txt | |
| ``` | |
| 4. **Run the application** | |
| ```bash | |
| python app.py | |
| ``` | |
| 5. **Open in browser**: Navigate to `http://localhost:7860` | |
| 6. **Enter your HuggingFace token**: Get one at [huggingface.co/settings/tokens](https://huggingface.co/settings/tokens) | |
| ### Run Tests | |
| ```bash | |
| pytest test_app.py -v | |
| ``` | |
| ## 🐳 HuggingFace Spaces Deployment | |
| 1. **Create a new Space** at [huggingface.co/new-space](https://huggingface.co/new-space) | |
| - Select **Gradio** as the SDK | |
| - Choose **CPU basic** (free tier) | |
| 2. **Upload files** | |
| - `app.py` | |
| - `config.py` | |
| - `requirements.txt` | |
| - `README.md` (optional) | |
| 3. **That's it!** The Space will automatically build and deploy. | |
| ## 📁 Project Structure | |
| ``` | |
| geoai-coding-agent/ | |
| ├── app.py # Main Gradio application | |
| ├── config.py # Configuration, prompts, templates | |
| ├── test_app.py # Unit tests | |
| ├── requirements.txt # Python dependencies | |
| ├── .gitignore # Git ignore rules | |
| └── README.md # This file | |
| ``` | |
| ## 🎯 Example Queries | |
| - *"Read a GeoTIFF with rasterio and calculate NDVI from Sentinel-2 bands"* | |
| - *"Convert shapefile to GeoJSON using GDAL/OGR in Python"* | |
| - *"Reproject a raster from EPSG:4326 to EPSG:32632 using rasterio"* | |
| - *"Clip a large COG raster to a polygon boundary using rioxarray"* | |
| - *"Create a spatial join between two GeoDataFrames in GeoPandas"* | |
| - *"Implement parallel raster processing with GDAL in C++"* | |
| ## ⚙️ Configuration | |
| Key settings in `config.py`: | |
| | Parameter | Default | Description | | |
| | ---------------- | -------------------------------- | ------------------------------------------- | | |
| | `MODEL_ID` | `Qwen/Qwen2.5-Coder-7B-Instruct` | HuggingFace model | | |
| | `MAX_NEW_TOKENS` | `2048` | Maximum response length | | |
| | `TEMPERATURE` | `0.3` | Sampling temperature (lower = more focused) | | |
| | `TOP_P` | `0.9` | Nucleus sampling threshold | | |
| ## 🔑 API Token | |
| This application requires a **HuggingFace API token** for inference. This design: | |
| - ✅ Keeps the Space free (no server-side costs) | |
| - ✅ Prevents token limit overflow | |
| - ✅ Gives users control over their usage | |
| Get your free token at: [huggingface.co/settings/tokens](https://huggingface.co/settings/tokens) | |
| ## 🛠️ Supported Languages | |
| | Language | Extension | Use Case | | |
| |------------|--------------|-------------------------------| | |
| | Python | `.py` | GDAL, Rasterio, GeoPandas | | |
| | Java | `.java` | GeoTools, JTS | | |
| | C/C++ | `.c`, `.cpp` | GDAL C API, performance | | |
| | JavaScript | `.js` | Leaflet, OpenLayers, Turf.js | | |
| | TypeScript | `.ts` | Type-safe geospatial apps | | |
| | Rust | `.rs` | GDAL Rust bindings, geo crate | | |
| ## 📦 Dependencies | |
| - **gradio**: Web UI framework | |
| - **huggingface-hub**: HF Inference API client | |
| - **pytest**: Testing framework | |
| ## 🙏 Acknowledgments | |
| - Inspired by [GeoAI-Assistance-Ext](https://github.com/rifatSDAS/GeoAI-Assistance-Ext) VS Code Extension | |
| - Powered by [Qwen2.5-Coder](https://huggingface.co/Qwen/Qwen2.5-Coder-7B-Instruct) | |
| - Built with [Gradio](https://gradio.app/) | |
| ## About the Developer | |
| Built by Dr. Kazi Rifat Ahmed, a **Full Stack Geospatial AI Engineer** specializing in: | |
| - AI/ML-DL for geospatial applications | |
| - Cloud-native geospatial software engineering & architecture | |
| - Large-scale Satellite/Earth Observation data data analysis, processing, analytics, and visualization | |
| - Blockchain and Quantum Computing for geospatial applications | |
| - Research Advanced Geospatial Science, Technology, and Applications | |
| - Co-founder and Technical Lead for Satellite Data Services business in Space sector, i.e., QuentuED (https://quentued.de) and Sensor Aktor (https://sensor-aktor.de) | |
| ### Tech Stack Proficiency | |
| Python | Java | JavaScript | TypeScript | C/C++ | Bash | Cloud-Native Architecture (kubernetes) | DevOps | AI/ML/DL | MLOps | LLM Integration | Blockchain | Remote Sensing Science & Technology | Geospatial Data Science & Engineering | |
| ### Research Interests | |
| Geospatial AI | Satellite Data Engineering | Drone Sensors | Geospatial Big Data Analytics | Earth Observation Systems & Sensors | Advanced Remote Sensing Techniques | Space Technology | Quantum Computing | Blockchain | | Satellite Data Services | Planetary Science & Exploration | |
| ## 🤝 Contributing | |
| Contributions are welcome! Please: | |
| 1. Fork the repository | |
| 2. Create a feature branch | |
| 3. Make your changes | |
| 4. Run tests: `pytest test_app.py -v` | |
| 5. Submit a pull request | |
| ## 📄 License | |
| This project is licensed under the **GNU Affero General Public License v3.0** (AGPL-3.0). | |
| See [LICENSE](LICENSE.md) for details. | |
| ## Contact | |
| For collaboration opportunities in satellite data services & applications, large-scale satellite data analytics, geospatial AI, blockchain & quantum computing for geospatial applications, or advanced geospatial science, technology & applications, feel free to reach out! | |
| --- | |
| Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference | |