Geo Assistant

A geographic assistant that helps answer questions and perform tasks related to locations and geographic data.

Environment Setup

The project uses environment variables for configuration. Copy .env.example to .env and customize as needed:

cp .env.example .env

Edit .env to set your configuration:

• OLLAMA_MODEL: Model name (default: llama3.2)
• OLLAMA_BASE_URL: Ollama server URL (default: http://localhost:11434)
• API_BASE_URL: API base URL for the frontend (default: http://localhost:8000)

The application will automatically load these variables from the .env file.

Development Setup

Pre-commit Hooks

This project uses pre-commit hooks to ensure code quality. To set up pre-commit:

1. Install dependencies (including pre-commit):

uv sync

2. Install the git hooks:

uv run pre-commit install

Pre-commit will now automatically run ruff linting and formatting checks before each commit.

To manually run pre-commit on all files:

uv run pre-commit run --all-files

Running the API

uvicorn geo_assistant.api.app:app --reload

The API will be available at http://localhost:8000.

Running the Frontend

streamlit run src/geo_assistant/frontend/app.py

The frontend will be available at http://localhost:8501.