---
id: "run-locally"
type: "guide"
title: "Run Enrichments Services locally"
summary: "Install deps, copy .env, build, and serve on port 3100."
why: "Local serve is the fastest way to verify catalog and enrichment routes."
audiences: ["developers"]
related: ["call-enrich-endpoint"]
invariants: ["GITHUB_TOKEN is required at npm install for @neo-agentics packages"]
confirmationRequired: false
---
# Run Enrichments Services locally

# Run Enrichments Services locally

## Use this when

- You need a local HTTP server for enrichment calls
- You are validating env and Mongo connectivity

## Do not use this when

- You only need the knowledge SDK / docs site (`npm run docs`)

## Steps

1. **Configure GitHub Packages** — Ensure `.npmrc` scopes `@neo-agentics` and `GITHUB_TOKEN` is set.
2. **Install and env** — `npm install` then `cp .env.example .env`.
3. **Build and test** — `npm run build` then `npm test`.
4. **Serve** — `npm run serve` (default `http://0.0.0.0:3100`).

## Verification

- `GET /health` returns OK
- `GET /api/catalog` lists enrichment types

## Recovery

- 401/404 on `@neo-agentics` install → refresh `GITHUB_TOKEN`
- Mongo errors on custom/memorix context → set `MONGO_URI`