https://github.com/maprva/georeference-tool
A Django web application for georeferencing historical images
https://github.com/maprva/georeference-tool
Last synced: 9 months ago
JSON representation
A Django web application for georeferencing historical images
- Host: GitHub
- URL: https://github.com/maprva/georeference-tool
- Owner: MapRVA
- License: agpl-3.0
- Created: 2025-09-08T18:09:38.000Z (10 months ago)
- Default Branch: trunk
- Last Pushed: 2025-10-06T07:14:58.000Z (9 months ago)
- Last Synced: 2025-10-06T09:31:42.978Z (9 months ago)
- Language: HTML
- Homepage: https://georeference.maprva.org
- Size: 911 KB
- Stars: 4
- Watchers: 1
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Georeference Tool
A Django web application for georeferencing historical images.
## Local development
To run georeference-tool locally, you need [`uv`](https://docs.astral.sh/uv/) and a PostgreSQL
database with pgvector and postgis.
### Run Database
The recommended way to run your database is using podman and
[MapRVA/cnpg-postgis-pgvector](https://github.com/MapRVA/cnpg-postgis-pgvector).
```
podman run -d --replace --name georef-postgres -e POSTGRES_DB=georef -e POSTGRES_USER=django_user -e POSTGRES_PASSWORD=dev_password -p 5432:5432 ghcr.io/maprva/postgis-pgvector-local:latest
```
### Set up environment variables
Setup the following env vars:
```
export LOCAL_DEV=1
export ALLOW_HARDCODED_ADMIN=1
export DJANGO_DEBUG=1
export PG_DBNAME=georef
export PG_USER=django_user
export PG_PASSWORD=dev_password
export PG_HOST=localhost
export PG_PORT=5432
export PG_SSL_MODE=disable
```
### Install dependencies
```
uv sync
```
### Apply migrations
```
uv run manage.py migrate
```
### Run the dev server!
```
uv run manage.py runserver
```
### Load a collection
```
uv run scripts/importers/library_of_virginia.py --area A
```
### Admin creds
You can login to `/admin` with the username & password: `admin`