MCPcopy
hub / github.com/open-wanderer/wanderer

github.com/open-wanderer/wanderer @v0.19.3 sqlite

repository ↗ · DeepWiki ↗ · release v0.19.3 ↗
1,140 symbols 2,925 edges 452 files 27 documented · 2%
README

The trail catalogue that makes your GPS data searchable

Docker Image Version (tag latest semver) GitHub Repo stars Buy Me A Coffee Discord

Try the demo

wanderer is a self-hosted trail database. You can upload your recorded tracks or create new ones and add various metadata to build an easily searchable catalogue.

Core Features

Screenshot of wanderer

  • Manage your trails
  • Plan new routes
  • Extensive map integration and visualization
  • Share trails with other people and explore theirs
  • Advanced filter and search functionality
  • Create custom lists to organize your trails further

Getting started

The recommended and quickest way to install wanderer is using docker compose:

# download the docker compose file
wget https://raw.githubusercontent.com/open-wanderer/wanderer/main/docker-compose.yml

# build and launch via docker compose
docker compose up -d

The first startup can take up to 90 seconds after which you can access the frontend at localhost:3000.

ℹ️ if you are not hosting wanderer at http://localhost:3000 make sure to change ORIGIN variable. Otherwise you will run into CORS errors.

⚠️ if you are using wanderer in a production environment make sure to change the MEILI_MASTER_KEY variable.

You can also run wanderer on bare-metal. Check out the documentation for a detailed how-to guide.

Support wanderer

If you like wanderer and would like to give something back you can donate over here. If you prefer to support the development with a regular contribution you can donate via Liberapay.

Documentation

Please check the website for the complete documentation.

Contributing

Help is welcome at any time. If you are not sure where you can start check the roadmap for features in the backlog. If you would like to contribute a translation, you can do so here.

License

This project is licensed under the AGPLv3 License. See the LICENSE file for the full license text.

Extension points exported contracts — how you extend this code

Server (Interface)
(no doc)
docs/src/models/server.ts
Locals (Interface)
(no doc)
web/src/app.d.ts
TrailMergeSuggestCandidate (Interface)
(no doc)
web/src/lib/stores/trail_merge_api.ts
TrailMergeSuggestResponse (Interface)
(no doc)
web/src/lib/stores/trail_merge_api.ts
TrailMergeSuggestGroup (Interface)
(no doc)
web/src/lib/stores/trail_merge_api.ts
TrailMergeSuggestGroupsResponse (Interface)
(no doc)
web/src/lib/stores/trail_merge_api.ts

Core symbols most depended-on inside this repo

handleError
called by 115
web/src/lib/util/api_util.ts
parse
called by 46
web/src/lib/models/gpx/gpx.ts
toString
called by 36
web/src/lib/models/gpx/gpx.ts
remove
called by 15
web/src/lib/util/api_util.ts
PostActivity
called by 14
db/federation/activity.go
goto
called by 11
web/tests/playwright/pages/lists_page.ts
getTotals
called by 8
web/src/lib/models/gpx/gpx.ts
delete
called by 7
web/tests/playwright/pages/lists_page.ts

Shape

Function 811
Struct 148
Class 68
Method 68
Interface 39
Enum 3
TypeAlias 3

Languages

Go51%
TypeScript49%

Modules by API surface

db/services/trailmerge/service.go63 symbols
db/integrations/komoot/models.go62 symbols
db/integrations/strava/models.go29 symbols
db/integrations/hammerhead/models.go25 symbols
db/integrations/hammerhead/hammerhead.go24 symbols
web/src/lib/stores/valhalla_store.svelte.ts18 symbols
web/src/lib/util/gpx_util.ts16 symbols
db/integrations/komoot/komoot.go16 symbols
web/src/lib/stores/trail_store.ts15 symbols
db/integrations/strava/strava.go15 symbols
db/main.go14 symbols
web/src/lib/util/api_util.ts13 symbols

Dependencies from manifests, versioned

github.com/andybalholm/brotliv1.2.0 · 1×
github.com/asaskevich/govalidatorv0.0.0-2023030114320 · 1×
github.com/aymerick/douceurv0.2.0 · 1×
github.com/disintegration/imagingv1.6.2 · 1×
github.com/domodwyer/mailyak/v3v3.6.2 · 1×
github.com/fsnotify/fsnotifyv1.7.0 · 1×
github.com/gabriel-vasile/mimetypev1.4.13 · 1×
github.com/ganigeorgiev/fexprv0.5.0 · 1×
github.com/go-ap/activitypubv0.0.0-2025090510244 · 1×
github.com/go-ap/errorsv0.0.0-2025090510235 · 1×

For agents

$ claude mcp add wanderer \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact