Spaces:
Running
Running
Update README
Browse files
README.md
CHANGED
|
@@ -28,23 +28,37 @@ short_description: GeoAI Coding Agent - Geospatial AI Coding Assistant"
|
|
| 28 |
|
| 29 |
# π GeoAI Coding Agent
|
| 30 |
|
| 31 |
-
A **Geospatial AI Coding Assistant** powered by
|
| 32 |
|
| 33 |
-
Specialized in **GDAL/OGR**, **Rasterio**, **GeoPandas**, **xarray**, and geospatial development across multiple programming languages.
|
| 34 |
|
| 35 |

|
| 36 |
-

|
| 38 |
|
| 39 |
## β¨ Features
|
| 40 |
|
|
|
|
| 41 |
- **πΊοΈ Geospatial Expertise**: Deep knowledge of GDAL, Rasterio, GeoPandas, PyProj, xarray, and rioxarray
|
|
|
|
| 42 |
- **π» Multi-Language Support**: Python, Java, C/C++, JavaScript, TypeScript, Rust
|
| 43 |
-
- **π₯ Download Options**: Export responses as Markdown
|
| 44 |
- **π¨ Code Editor Style UI**: Syntax highlighting with dark theme
|
| 45 |
-
- **π BYOT (Bring Your Own Token)**: Uses your HuggingFace API token for inference
|
| 46 |
- **β‘ Streaming Responses**: Real-time token streaming for better UX
|
| 47 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 48 |
## π Quick Start
|
| 49 |
|
| 50 |
### Local Development
|
|
@@ -122,22 +136,25 @@ geoai-coding-agent/
|
|
| 122 |
|
| 123 |
Key settings in `config.py`:
|
| 124 |
|
| 125 |
-
| Parameter
|
| 126 |
-
|
|
| 127 |
-
| `
|
| 128 |
-
| `MAX_NEW_TOKENS`
|
| 129 |
-
| `TEMPERATURE`
|
| 130 |
-
| `TOP_P`
|
|
|
|
| 131 |
|
| 132 |
## π API Token
|
| 133 |
|
| 134 |
-
This application requires a **HuggingFace API token**
|
| 135 |
-
|
| 136 |
-
|
| 137 |
-
- β
|
| 138 |
|
| 139 |
Get your free token at: [huggingface.co/settings/tokens](https://huggingface.co/settings/tokens)
|
| 140 |
|
|
|
|
|
|
|
| 141 |
## π οΈ Supported Languages
|
| 142 |
|
| 143 |
| Language | Extension | Use Case |
|
|
@@ -158,8 +175,8 @@ Get your free token at: [huggingface.co/settings/tokens](https://huggingface.co/
|
|
| 158 |
## π Acknowledgments
|
| 159 |
|
| 160 |
- Inspired by [GeoAI-Assistance-Ext](https://github.com/rifatSDAS/GeoAI-Assistance-Ext) VS Code Extension
|
| 161 |
-
- Powered by [
|
| 162 |
-
- Built with [Gradio](https://gradio.app/)
|
| 163 |
|
| 164 |
## About the Developer
|
| 165 |
|
|
|
|
| 28 |
|
| 29 |
# π GeoAI Coding Agent
|
| 30 |
|
| 31 |
+
A **Geospatial AI Coding Assistant** powered by multiple LLMs via HuggingFace Inference Providers.
|
| 32 |
|
| 33 |
+
Specialized in **GDAL/OGR**, **Rasterio**, **GeoPandas**, **xarray**, and geospatial development across multiple programming languages. Designed for **beginner and intermediate learners** with educational explanations.
|
| 34 |
|
| 35 |

|
| 36 |
+

|
| 37 |

|
| 38 |
|
| 39 |
## β¨ Features
|
| 40 |
|
| 41 |
+
- **π€ Multiple AI Models**: Choose from 6 different models (DeepSeek, Kimi, Llama, MiniMax, GLM, Mistral)
|
| 42 |
- **πΊοΈ Geospatial Expertise**: Deep knowledge of GDAL, Rasterio, GeoPandas, PyProj, xarray, and rioxarray
|
| 43 |
+
- **π Educational Focus**: Responses include code explanations, step-by-step logic, and tips for beginners
|
| 44 |
- **π» Multi-Language Support**: Python, Java, C/C++, JavaScript, TypeScript, Rust
|
| 45 |
+
- **π₯ Download Options**: Export responses as Markdown or code files
|
| 46 |
- **π¨ Code Editor Style UI**: Syntax highlighting with dark theme
|
|
|
|
| 47 |
- **β‘ Streaming Responses**: Real-time token streaming for better UX
|
| 48 |
|
| 49 |
+
## π€ Available Models
|
| 50 |
+
|
| 51 |
+
| Model | Provider | Speed | Best For |
|
| 52 |
+
|-------|----------|-------|----------|
|
| 53 |
+
| **DeepSeek V3.2** | Novita | Medium | Complex geospatial tasks, detailed explanations |
|
| 54 |
+
| **Kimi K2 Instruct** | Novita | Medium | General coding, good balance |
|
| 55 |
+
| **Llama 3.1 8B** | Novita | Fast | Quick answers, simple tasks |
|
| 56 |
+
| **MiniMax M2.1** | Novita | Medium | Creative solutions |
|
| 57 |
+
| **GLM 4.7 Flash** | Novita | Fast | Fast responses, basic tasks |
|
| 58 |
+
| **Mistral 7B v0.2** | Featherless | Fast | Quick prototyping |
|
| 59 |
+
|
| 60 |
+
> π‘ **Tip**: Larger models provide better results but take longer. Smaller models are faster for simple queries.
|
| 61 |
+
|
| 62 |
## π Quick Start
|
| 63 |
|
| 64 |
### Local Development
|
|
|
|
| 136 |
|
| 137 |
Key settings in `config.py`:
|
| 138 |
|
| 139 |
+
| Parameter | Default | Description |
|
| 140 |
+
| ------------------ | ----------------- | ------------------------------------------- |
|
| 141 |
+
| `DEFAULT_MODEL` | `DeepSeek V3.2` | Default model selection |
|
| 142 |
+
| `MAX_NEW_TOKENS` | `2048` | Maximum response length |
|
| 143 |
+
| `TEMPERATURE` | `0.3` | Sampling temperature (lower = more focused) |
|
| 144 |
+
| `TOP_P` | `0.9` | Nucleus sampling threshold |
|
| 145 |
+
| `AVAILABLE_MODELS` | (see table above) | Dictionary of available models & providers |
|
| 146 |
|
| 147 |
## π API Token
|
| 148 |
|
| 149 |
+
This application requires a **HuggingFace API token** with Inference Provider permissions.
|
| 150 |
+
|
| 151 |
+
**Required permissions**:
|
| 152 |
+
- β
Make calls to Inference Providers
|
| 153 |
|
| 154 |
Get your free token at: [huggingface.co/settings/tokens](https://huggingface.co/settings/tokens)
|
| 155 |
|
| 156 |
+
For HuggingFace Spaces deployment, add the token as a **Secret** named `HF_TOKEN` in Space Settings.
|
| 157 |
+
|
| 158 |
## π οΈ Supported Languages
|
| 159 |
|
| 160 |
| Language | Extension | Use Case |
|
|
|
|
| 175 |
## π Acknowledgments
|
| 176 |
|
| 177 |
- Inspired by [GeoAI-Assistance-Ext](https://github.com/rifatSDAS/GeoAI-Assistance-Ext) VS Code Extension
|
| 178 |
+
- Powered by multiple LLMs via [HuggingFace Inference Providers](https://huggingface.co/docs/huggingface_hub/guides/inference)
|
| 179 |
+
- Built with [Gradio](https://gradio.app/)
|
| 180 |
|
| 181 |
## About the Developer
|
| 182 |
|