poimen-memory/LOCAL_DEV.md

Local Development Setup

Running poimen-memory locally for development.

Quick Start

1. Copy env template:

   cp .env.example .env
   

2. Edit .env with your local endpoints:

   # Edit .env with your local/dev service URLs
   # Example: LLM service on localhost:11434, OpenSearch on localhost:9200
   

3. Run the service:

   cargo run --release -- serve --port 8080
   

The application loads configuration from .env (via dotenvy or similar).

.env File

Location: Project root (.env) Status: Gitignored - never committed Template: .env.example (included in repo, shows all available variables)

Key Variables

# Database
DATABASE_URL=postgresql://user:pass@localhost:5432/memory

# LLM (point to your local LLM service)
LLM_ENDPOINT=http://localhost:11434/v1/chat/completions
LLM_MODEL=qwen:7b

# OpenSearch (local vector store)
OPENSEARCH_HOST=localhost:9200

# Auth (disabled for local dev)
MEM_AUTH_MODE=none

# API Key (test key for local dev)
MEM_API_KEY=test-key

Local Service Stack (Example)

# Terminal 1: OpenSearch
docker run -d -p 9200:9200 -e OPENSEARCH_JAVA_OPTS="-Xms512m -Xmx512m" \
  opensearchproject/opensearch:latest

# Terminal 2: Ollama (LLM)
ollama serve

# Terminal 3: poimen-memory
cargo run --release -- serve --port 8080

Production vs Local

Aspect	Production (K8s)	Local Dev
Config	k8s/app/config.yaml (SOPS-encrypted)	.env (gitignored)
Injection	ConfigMap via envFrom:	dotenv via dotenvy crate
Services	Cluster-internal DNS	localhost/127.0.0.1
Auth	JWT (Authentik)	None (disabled)
Commit?	Yes (encrypted)	No (gitignored)

Switching to Production Config

To run against production services (not recommended locally):

1. Edit .env with production URLs
2. Set credentials appropriately
3. Ensure network access to production services

---

See .env.example for all available environment variables.