README.md

---
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.

![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)
![Gradio](https://img.shields.io/badge/Gradio-4.19+-orange.svg)
![License](https://img.shields.io/badge/License-AGPL--3.0-green.svg)

## ✨ 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