@cybermem/mcp 0.1.0 → 0.5.1

package/dist/templates/ansible/inventory/hosts.ini

@@ -0,0 +1,3 @@
+[rpi]
+# Replace with your RPi IP address
+raspberrypi.local ansible_user=pi ansible_ssh_pass=Darwin1809 ansible_python_interpreter=/usr/bin/python3

package/dist/templates/ansible/playbooks/deploy-cybermem.yml

@@ -0,0 +1,71 @@
+---
+- name: Deploy CyberMem to Raspberry Pi
+  hosts: rpi
+  become: yes
+  vars:
+    project_dir: /home/{{ ansible_user }}/cybermem
+    env_file: .env.rpi
+
+  tasks:
+    - name: Update apt cache
+      apt:
+        update_cache: yes
+        cache_valid_time: 3600
+
+    - name: Install dependencies
+      apt:
+        name:
+          - git
+          - rsync
+        state: present
+
+    - name: Ensure Docker service is running
+      service:
+        name: docker
+        state: started
+        enabled: yes
+
+    - name: Add user to docker group
+      user:
+        name: "{{ ansible_user }}"
+        groups: docker
+        append: yes
+
+    - name: Create project directory
+      file:
+        path: "{{ project_dir }}"
+        state: directory
+        owner: "{{ ansible_user }}"
+        group: "{{ ansible_user }}"
+        mode: "0755"
+
+    - name: Synchronize project files
+      synchronize:
+        src: "{{ playbook_dir }}/../../"
+        dest: "{{ project_dir }}"
+        rsync_opts:
+          - "--exclude=.git"
+          - "--exclude=node_modules"
+          - "--exclude=.next"
+          - "--exclude=dashboard/.next"
+          - "--exclude=*.log"
+          - "--exclude=tmp"
+          - "--exclude=__pycache__"
+
+    - name: Copy environment file
+      copy:
+        src: "../../{{ env_file }}"
+        dest: "{{ project_dir }}/.env"
+        owner: "{{ ansible_user }}"
+        group: "{{ ansible_user }}"
+        mode: "0600"
+
+    - name: Pull and start services
+      command: docker-compose -f docker-compose.prod.yml --profile ollama up -d --pull always
+      args:
+        chdir: "{{ project_dir }}"
+      register: compose_output
+
+    - name: Show deployment status
+      debug:
+        var: compose_output.stdout_lines

package/dist/templates/ansible/playbooks/stop-cybermem.yml

@@ -0,0 +1,17 @@
+---
+- name: Stop CyberMem on Raspberry Pi
+  hosts: rpi
+  become: yes
+  vars:
+    project_dir: /home/{{ ansible_user }}/cybermem
+
+  tasks:
+    - name: Stop services
+      command: docker-compose down
+      args:
+        chdir: "{{ project_dir }}"
+      register: down_output
+
+    - name: Show stop status
+      debug:
+        var: down_output.stdout_lines

package/dist/templates/charts/cybermem/Chart.yaml

@@ -0,0 +1,6 @@
+apiVersion: v2
+name: cybermem
+description: A Helm chart for CyberMem AI Memory System
+type: application
+version: 0.1.0
+appVersion: "1.0.0"

package/dist/templates/charts/cybermem/templates/dashboard-deployment.yaml

@@ -0,0 +1,29 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ .Chart.Name }}-dashboard
+  labels:
+    app.kubernetes.io/name: dashboard
+spec:
+  replicas: {{ .Values.dashboard.replicaCount }}
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: dashboard
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: dashboard
+    spec:
+      containers:
+        - name: dashboard
+          image: "{{ .Values.dashboard.image.repository }}:{{ .Values.dashboard.image.tag }}"
+          imagePullPolicy: {{ .Values.dashboard.image.pullPolicy }}
+          ports:
+            - name: http
+              containerPort: 3000
+              protocol: TCP
+          env:
+            - name: NEXT_PUBLIC_API_URL
+              value: "http://{{ .Chart.Name }}-openmemory:8080"
+          resources:
+            {{- toYaml .Values.dashboard.resources | nindent 12 }}

package/dist/templates/charts/cybermem/templates/dashboard-service.yaml

@@ -0,0 +1,20 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ .Chart.Name }}-dashboard
+spec:
+  type: {{ .Values.dashboard.service.type }}
+  ports:
+    - port: {{ .Values.dashboard.service.port }}
+      targetPort: http
+      protocol: TCP
+      name: http
+    {{- if eq .Values.dashboard.service.type "NodePort" }}
+    - port: {{ .Values.dashboard.service.port }}
+      targetPort: http
+      nodePort: {{ .Values.dashboard.service.nodePort }}
+      protocol: TCP
+      name: http-node
+    {{- end }}
+  selector:
+    app.kubernetes.io/name: dashboard

package/dist/templates/charts/cybermem/templates/openmemory-deployment.yaml

@@ -0,0 +1,40 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ .Chart.Name }}-openmemory
+  labels:
+    app.kubernetes.io/name: openmemory
+spec:
+  replicas: {{ .Values.openmemory.replicaCount }}
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: openmemory
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: openmemory
+    spec:
+      containers:
+        - name: openmemory
+          image: "{{ .Values.openmemory.image.repository }}:{{ .Values.openmemory.image.tag }}"
+          imagePullPolicy: {{ .Values.openmemory.image.pullPolicy }}
+          ports:
+            - name: http
+              containerPort: 8080
+              protocol: TCP
+          env:
+            - name: OPENMEMORY_API_KEY
+              value: {{ .Values.env.OPENMEMORY_API_KEY | quote }}
+            - name: OPENAI_API_KEY
+              value: {{ .Values.env.OPENAI_API_KEY | quote }}
+            - name: DB_PATH
+              value: "/data/openmemory.sqlite"
+          volumeMounts:
+            - name: data
+              mountPath: /data
+          resources:
+            {{- toYaml .Values.openmemory.resources | nindent 12 }}
+      volumes:
+        - name: data
+          persistentVolumeClaim:
+            claimName: {{ .Chart.Name }}-openmemory-pvc

package/dist/templates/charts/cybermem/templates/openmemory-pvc.yaml

@@ -0,0 +1,10 @@
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: {{ .Chart.Name }}-openmemory-pvc
+spec:
+  accessModes:
+    - {{ .Values.openmemory.persistence.accessMode }}
+  resources:
+    requests:
+      storage: {{ .Values.openmemory.persistence.size }}

package/dist/templates/charts/cybermem/templates/openmemory-service.yaml

@@ -0,0 +1,13 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: {{ .Chart.Name }}-openmemory
+spec:
+  type: {{ .Values.openmemory.service.type }}
+  ports:
+    - port: {{ .Values.openmemory.service.port }}
+      targetPort: http
+      protocol: TCP
+      name: http
+  selector:
+    app.kubernetes.io/name: openmemory

package/dist/templates/charts/cybermem/values-vps.yaml

@@ -0,0 +1,18 @@
+# VPS Overrides
+
+openmemory:
+  image:
+    repository: ghcr.io/mikhailkogan17/cybermem-openmemory
+    pullPolicy: Always
+  service:
+    type: ClusterIP
+
+dashboard:
+  image:
+    repository: ghcr.io/mikhailkogan17/cybermem-dashboard
+    pullPolicy: Always
+
+env:
+  OPENMEMORY_API_KEY: "prod-secret-key-CHANGE-ME"
+  # Add your OpenAI Key here for production
+  OPENAI_API_KEY: "sk-..."

package/dist/templates/charts/cybermem/values.yaml

@@ -0,0 +1,42 @@
+# Default values for cybermem.
+
+openmemory:
+  image:
+    repository: cybermem-openmemory
+    pullPolicy: IfNotPresent
+    tag: "latest"
+  replicaCount: 1
+  service:
+    type: ClusterIP
+    port: 8080
+  persistence:
+    enabled: true
+    size: 10Gi
+    accessMode: ReadWriteOnce
+  resources:
+    limits:
+      cpu: 1000m
+      memory: 1Gi
+    requests:
+      cpu: 100m
+      memory: 256Mi
+  env:
+    # Passed to the container
+    OM_PORT: "8080"
+
+dashboard:
+  image:
+    repository: cybermem-dashboard
+    pullPolicy: IfNotPresent
+    tag: "latest"
+  replicaCount: 1
+  service:
+    type: ClusterIP
+    port: 3000
+    nodePort: 30000 # For k3d/local access if needed
+  resources: {}
+
+env:
+  # Shared secrets
+  OPENMEMORY_API_KEY: "dev-secret-key"
+  OPENAI_API_KEY: ""

package/dist/templates/docker-compose.yml

@@ -0,0 +1,219 @@
+# CyberMem - OpenMemory + DevOps monitoring stack
+# For local development only
+# Production deployment: use Helm chart (charts/cybermem/)
+
+services:
+  traefik:
+    image: traefik:v3.0
+    container_name: cybermem-traefik
+    command:
+      - --api.dashboard=true
+      - --api.insecure=true
+      - --providers.docker=true
+      - --providers.docker.exposedbydefault=false
+      - --entrypoints.web.address=:8626
+      - --accesslog=true
+      - --accesslog.filepath=/var/log/traefik/access.log
+      - --accesslog.format=json
+    ports:
+      - "8626:8626"
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+      - ./monitoring/traefik/traefik.yml:/etc/traefik/traefik.yml:ro
+      - traefik-logs:/var/log/traefik
+    labels:
+      - traefik.enable=true
+    restart: unless-stopped
+
+  openmemory:
+    image: ghcr.io/mikhailkogan17/cybermem-openmemory:latest
+    container_name: cybermem-openmemory
+    ports: [] # Access via Traefik on 8626
+    volumes:
+      - openmemory-data:/data
+      - ${CYBERMEM_ENV_PATH}:/.env
+    environment:
+      # Core settings
+      OM_PORT: "8080"
+      OM_TIER: "deep"
+      # API Key is loaded from /.env file
+
+      # Embeddings (local dev uses Ollama)
+      OM_EMBEDDINGS: ${EMBEDDINGS_PROVIDER:-ollama}
+      OLLAMA_URL: ${OLLAMA_URL:-http://ollama:11434}
+      OPENAI_API_KEY: ${OPENAI_API_KEY:-}
+
+      # Database (local dev uses SQLite)
+      OM_METADATA_BACKEND: ${DB_BACKEND:-sqlite}
+      OM_DB_PATH: ${DB_PATH:-/data/openmemory.sqlite}
+      OM_VECTOR_BACKEND: ${VECTOR_BACKEND:-sqlite}
+
+      # PostgreSQL (for production/testing)
+      OM_PG_HOST: ${PG_HOST:-postgres}
+      OM_PG_PORT: ${PG_PORT:-5432}
+      OM_PG_DB: ${PG_DB:-openmemory}
+      OM_PG_USER: ${PG_USER:-openmemory}
+      OM_PG_PASSWORD: ${PG_PASSWORD:-}
+
+      # Performance
+      OM_RATE_LIMIT_ENABLED: "true"
+      OM_RATE_LIMIT_MAX_REQUESTS: "1000"
+
+    labels:
+      - traefik.enable=true
+      - traefik.http.routers.openmemory.entrypoints=web
+      - traefik.http.routers.openmemory.rule=PathPrefix(`/memory`) || PathPrefix(`/health`) || PathPrefix(`/v1`) || PathPrefix(`/api`) || PathPrefix(`/all`) || PathPrefix(`/add`) || PathPrefix(`/mcp`) || PathPrefix(`/sse`)
+      - traefik.http.services.openmemory.loadbalancer.server.port=8080
+    healthcheck:
+      test:
+        [
+          "CMD",
+          "wget",
+          "--quiet",
+          "--tries=1",
+          "--spider",
+          "http://localhost:8080/health",
+        ]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+    restart: unless-stopped
+    depends_on:
+      - traefik
+
+  db-exporter:
+    image: ghcr.io/mikhailkogan17/cybermem-db_exporter:latest
+    container_name: cybermem-db-exporter
+    environment:
+      DB_PATH: /data/openmemory.sqlite
+      SCRAPE_INTERVAL: "15"
+      EXPORTER_PORT: "8000"
+    ports:
+      - "8000:8000"
+    volumes:
+      - openmemory-data:/data:ro
+    restart: unless-stopped
+    depends_on:
+      - openmemory
+
+  log-exporter:
+    image: ghcr.io/mikhailkogan17/cybermem-log_exporter:latest
+    container_name: cybermem-log-exporter
+    environment:
+      LOG_FILE: /var/log/traefik/access.log
+      SCRAPE_INTERVAL: "5"
+      EXPORTER_PORT: "8001"
+      DB_PATH: /data/openmemory.sqlite
+    volumes:
+      - traefik-logs:/var/log/traefik:ro
+      - openmemory-data:/data
+      - ./monitoring/log_exporter/exporter.py:/app/exporter.py:ro
+    restart: unless-stopped
+    depends_on:
+      - traefik
+      - openmemory
+
+  postgres:
+    image: postgres:15-alpine
+    container_name: cybermem-postgres
+    environment:
+      POSTGRES_DB: ${PG_DB:-openmemory}
+      POSTGRES_USER: ${PG_USER:-openmemory}
+      POSTGRES_PASSWORD: ${PG_PASSWORD:-postgres}
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres-data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${PG_USER:-openmemory}"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    restart: unless-stopped
+    profiles:
+      - postgres
+
+  postgres-exporter:
+    image: prometheuscommunity/postgres-exporter:v0.15.0
+    container_name: cybermem-postgres-exporter
+    environment:
+      DATA_SOURCE_NAME: postgresql://${PG_USER:-openmemory}:${PG_PASSWORD:-postgres}@postgres:5432/${PG_DB:-openmemory}?sslmode=disable
+      PG_EXPORTER_EXTEND_QUERY_PATH: /queries.yml
+    ports:
+      - "9187:9187"
+    volumes:
+      - ./monitoring/postgres_exporter/queries.yml:/queries.yml:ro
+    restart: unless-stopped
+    depends_on:
+      - postgres
+    profiles:
+      - postgres
+
+  ollama:
+    image: ollama/ollama:latest
+    container_name: cybermem-ollama
+    ports:
+      - "11434:11434"
+    volumes:
+      - ollama-models:/root/.ollama
+    restart: unless-stopped
+    profiles:
+      - ollama
+
+  prometheus:
+    image: prom/prometheus:v2.48.0
+    container_name: cybermem-prometheus
+    command:
+      - --config.file=/etc/prometheus/prometheus.yml
+      - --storage.tsdb.path=/prometheus
+      - --storage.tsdb.retention.time=${PROM_RETENTION:-7d}
+      - --web.console.libraries=/usr/share/prometheus/console_libraries
+      - --web.console.templates=/usr/share/prometheus/consoles
+    ports:
+      - "9092:9090"
+    volumes:
+      - ./monitoring/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro
+      - prometheus-data:/prometheus
+    restart: unless-stopped
+    depends_on:
+      - db-exporter
+
+  dashboard:
+    image: ghcr.io/mikhailkogan17/cybermem-dashboard:latest
+    container_name: cybermem-dashboard
+    environment:
+      NEXT_PUBLIC_PROMETHEUS_URL: http://prometheus:9090
+      PROMETHEUS_URL: http://prometheus:9090
+      OM_API_KEY: ${OM_API_KEY:-dev-secret-key}
+      # WATCHPACK_POLLING: "true" # Enable if hot reload blocks (high CPU usage)
+    ports:
+      - "3000:3000"
+    volumes:
+      - openmemory-data:/data
+      - /var/run/docker.sock:/var/run/docker.sock
+      - ${CYBERMEM_ENV_PATH}:/app/shared.env
+    restart: unless-stopped
+    depends_on:
+      - prometheus
+
+volumes:
+  openmemory-data:
+    name: cybermem-openmemory-data
+    driver: local
+  postgres-data:
+    name: cybermem-postgres-data
+    driver: local
+  ollama-models:
+    name: cybermem-ollama-models
+    driver: local
+  prometheus-data:
+    name: cybermem-prometheus-data
+    driver: local
+  traefik-logs:
+    name: cybermem-traefik-logs
+    driver: local
+
+networks:
+  default:
+    name: cybermem-network

package/dist/templates/envs/local.example

@@ -0,0 +1,27 @@
+# Example environment configuration
+# Copy to .env and customize
+
+# Embeddings provider: ollama (local) or openai (cloud)
+EMBEDDINGS_PROVIDER=ollama
+OLLAMA_URL=http://ollama:11434
+OPENAI_API_KEY=
+
+# Database backend: sqlite (local/rpi) or postgres (vps)
+DB_BACKEND=sqlite
+DB_PATH=/data/openmemory.sqlite
+VECTOR_BACKEND=sqlite
+
+# PostgreSQL settings (only for DB_BACKEND=postgres)
+PG_HOST=postgres
+PG_PORT=5432
+PG_DB=openmemory
+PG_USER=openmemory
+PG_PASSWORD=change-me
+
+# OpenMemory API key (Optional for local mode)
+# CYBERMEM_API_KEY=
+
+# Monitoring
+PROM_RETENTION=7d
+GRAFANA_USER=admin
+GRAFANA_PASSWORD=admin

package/dist/templates/envs/rpi.example

@@ -0,0 +1,27 @@
+# Raspberry Pi environment
+# Optimized for low memory (1GB total)
+DOCKER_PLATFORM=linux/arm64
+
+
+# Embeddings (use Ollama with small models)
+EMBEDDINGS_PROVIDER=ollama
+OLLAMA_URL=http://ollama:11434
+OPENAI_API_KEY=
+
+# Database (SQLite for RPi - low memory footprint)
+DB_BACKEND=sqlite
+DB_PATH=/data/openmemory.sqlite
+
+# PostgreSQL (not used)
+PG_HOST=postgres
+PG_DB=openmemory
+PG_USER=openmemory
+PG_PASSWORD=not-used
+
+# OpenMemory
+CYBERMEM_API_KEY=key-change-me
+
+# Monitoring (short retention for disk space)
+PROM_RETENTION=3d
+GRAFANA_USER=admin
+GRAFANA_PASSWORD=admin

package/dist/templates/envs/vps.example

@@ -0,0 +1,25 @@
+# VPS production environment
+# For Hetzner CX22 or similar (2 vCPU, 4GB RAM)
+
+# Embeddings (use OpenAI for production)
+EMBEDDINGS_PROVIDER=openai
+OPENAI_API_KEY=sk-change-me-in-production
+OLLAMA_URL=
+
+# Database (PostgreSQL for production)
+DB_BACKEND=postgres
+VECTOR_BACKEND=postgres
+
+# PostgreSQL
+PG_HOST=postgres
+PG_DB=openmemory
+PG_USER=openmemory
+PG_PASSWORD=change-me-in-production-use-secrets
+
+# OpenMemory
+CYBERMEM_API_KEY=change-me-in-production-use-secrets
+
+# Monitoring
+PROM_RETENTION=30d
+GRAFANA_USER=admin
+GRAFANA_PASSWORD=change-me-in-production-use-secrets

package/dist/templates/monitoring/db_exporter/Dockerfile

@@ -0,0 +1,19 @@
+FROM python:3.11-alpine
+
+WORKDIR /app
+
+# Install dependencies
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy exporter script
+COPY exporter.py .
+
+# Make script executable
+RUN chmod +x exporter.py
+
+# Expose Prometheus metrics port
+EXPOSE 8000
+
+# Run exporter
+CMD ["python", "-u", "exporter.py"]