Skip to content

#1 Persistent memory for AI coding agents based on real-world benchmarks

8.4 KB
Raw Blame
namespace: agentmemory
startup_timeout: 300s
stop_timeout: 20s
required_default: true
engine:
  url: ws://127.0.0.1:49134
  workers:
    configuration:
      adapter:
        name: fs
        config:
          directory: /data/config
    iii-worker-manager:
      host: 127.0.0.1
      port: 49134
containers:
  state:
    worker: package://api.workers.iii.dev/state
    version: "${STATE_VERSION}"
    config_name: state
    restart:
      condition: on-failure
      delay: 500ms
      max_delay: 30s
      max_attempts: 5
      window: 60s
    config_override:
      adapter:
        name: kv
        config:
          store_method: file_based
          file_path: /data/state_store.db
          save_interval_ms: "${AGENTMEMORY_STATE_SAVE_INTERVAL_MS:-2000}"
  http:
    worker: package://api.workers.iii.dev/http
    version: "${HTTP_VERSION}"
    config_name: http
    restart:
      condition: on-failure
      delay: 500ms
      max_delay: 30s
      max_attempts: 5
      window: 60s
    config_override:
      host: 0.0.0.0
      port: 3111
      default_timeout: 180000
      cors:
        allowed_origins: ["__REST_ALLOWED_ORIGINS__"]
        allowed_methods: [GET, POST, PUT, DELETE, OPTIONS]
  agentmemory:
    worker: path://.
    working_dir: /opt/agentmemory
    start_after: [state, http]
    startup_timeout: 300s
    config_name: agentmemory
    restart:
      condition: on-failure
      delay: 500ms
      max_delay: 30s
      max_attempts: 5
      window: 60s
    scripts:
      run: node /opt/agentmemory/dist/index.mjs
    environment:
      HOME: /data/home
      AGENTMEMORY_DATA_DIR: /data
      III_ENGINE_URL: ws://127.0.0.1:49134
      III_ENGINE_PORT: "49134"
      III_REST_PORT: "3111"
      III_VIEWER_PORT: "3113"
      III_TELEMETRY_ENABLED: "false"
      AGENTMEMORY_VIEWER_HOST: "${AGENTMEMORY_VIEWER_HOST:-0.0.0.0}"
      VIEWER_ALLOWED_HOSTS: "${VIEWER_ALLOWED_HOSTS:-localhost:3113,127.0.0.1:3113,[::1]:3113}"
      VIEWER_ALLOWED_ORIGINS: "${VIEWER_ALLOWED_ORIGINS:-http://localhost:3113,http://127.0.0.1:3113}"
      EMBEDDING_PROVIDER: "${EMBEDDING_PROVIDER:-}"
      OPENAI_API_KEY: "${OPENAI_API_KEY:-}"
      OPENAI_API_KEY_FOR_LLM: "${OPENAI_API_KEY_FOR_LLM:-}"
      OPENAI_BASE_URL: "${OPENAI_BASE_URL:-}"
      OPENAI_MODEL: "${OPENAI_MODEL:-}"
      OPENAI_EMBEDDING_API_KEY: "${OPENAI_EMBEDDING_API_KEY:-}"
      OPENAI_EMBEDDING_BASE_URL: "${OPENAI_EMBEDDING_BASE_URL:-}"
      OPENAI_EMBEDDING_MODEL: "${OPENAI_EMBEDDING_MODEL:-}"
      OPENAI_EMBEDDING_DIMENSIONS: "${OPENAI_EMBEDDING_DIMENSIONS:-}"
      ANTHROPIC_API_KEY: "${ANTHROPIC_API_KEY:-}"
      ANTHROPIC_BASE_URL: "${ANTHROPIC_BASE_URL:-}"
      ANTHROPIC_MODEL: "${ANTHROPIC_MODEL:-}"
      GEMINI_API_KEY: "${GEMINI_API_KEY:-}"
      GEMINI_MODEL: "${GEMINI_MODEL:-}"
      GOOGLE_API_KEY: "${GOOGLE_API_KEY:-}"
      VOYAGE_API_KEY: "${VOYAGE_API_KEY:-}"
      VOYAGE_MODEL: "${VOYAGE_MODEL:-}"
      COHERE_API_KEY: "${COHERE_API_KEY:-}"
      COHERE_MODEL: "${COHERE_MODEL:-}"
      OPENROUTER_API_KEY: "${OPENROUTER_API_KEY:-}"
      OPENROUTER_MODEL: "${OPENROUTER_MODEL:-}"
      MINIMAX_API_KEY: "${MINIMAX_API_KEY:-}"
      MINIMAX_MODEL: "${MINIMAX_MODEL:-}"
      OLLAMA_HOST: "${OLLAMA_HOST:-}"
      LLM_PROVIDER: "${LLM_PROVIDER:-}"
      BM25_WEIGHT: "${BM25_WEIGHT:-}"
      VECTOR_WEIGHT: "${VECTOR_WEIGHT:-}"
      MAX_TOKENS: "${MAX_TOKENS:-}"
      TOKEN_BUDGET: "${TOKEN_BUDGET:-}"
      MAX_OBS_PER_SESSION: "${MAX_OBS_PER_SESSION:-}"
      CONSOLIDATION_ENABLED: "${CONSOLIDATION_ENABLED:-}"
      GRAPH_EXTRACTION_ENABLED: "${GRAPH_EXTRACTION_ENABLED:-}"
      AGENTMEMORY_AUTO_COMPRESS: "${AGENTMEMORY_AUTO_COMPRESS:-}"
      AGENTMEMORY_INJECT_CONTEXT: "${AGENTMEMORY_INJECT_CONTEXT:-}"
      AGENTMEMORY_ALLOW_AGENT_SDK: "${AGENTMEMORY_ALLOW_AGENT_SDK:-}"
      AGENTMEMORY_SESSION_SWEEP_ENABLED: "${AGENTMEMORY_SESSION_SWEEP_ENABLED:-}"
      AGENTMEMORY_SESSION_SWEEP_STALE_HOURS: "${AGENTMEMORY_SESSION_SWEEP_STALE_HOURS:-}"
      AGENTMEMORY_FINALIZE_IDLE_MS: "${AGENTMEMORY_FINALIZE_IDLE_MS:-}"
      AGENTMEMORY_GRAPH_COMPACT_ON_BOOT: "${AGENTMEMORY_GRAPH_COMPACT_ON_BOOT:-}"
      AGENTMEMORY_DROP_STALE_INDEX: "${AGENTMEMORY_DROP_STALE_INDEX:-}"
      AGENTMEMORY_AUDIT_RETENTION_MONTHS: "${AGENTMEMORY_AUDIT_RETENTION_MONTHS:-}"
      AGENTMEMORY_AUDIT_MIGRATE_MAX_BYTES: "${AGENTMEMORY_AUDIT_MIGRATE_MAX_BYTES:-}"
      AGENTMEMORY_STATE_BACKEND: "${AGENTMEMORY_STATE_BACKEND:-}"
      AGENTMEMORY_REDIS_URL: "${AGENTMEMORY_REDIS_URL:-}"
      AGENTMEMORY_STATE_SAVE_INTERVAL_MS: "${AGENTMEMORY_STATE_SAVE_INTERVAL_MS:-}"
      AGENTMEMORY_SECRET: "${AGENTMEMORY_SECRET:-}"
      AGENT_ID: "${AGENT_ID:-}"
      TEAM_ID: "${TEAM_ID:-}"
      TEAM_MODE: "${TEAM_MODE:-}"
      USER_ID: "${USER_ID:-}"
      AGENTMEMORY_AGENT_SCOPE: "${AGENTMEMORY_AGENT_SCOPE:-}"
      SNAPSHOT_DIR: "${SNAPSHOT_DIR:-}"
      SNAPSHOT_ENABLED: "${SNAPSHOT_ENABLED:-}"
      SNAPSHOT_INTERVAL: "${SNAPSHOT_INTERVAL:-}"
      STANDALONE_PERSIST_PATH: "${STANDALONE_PERSIST_PATH:-}"
      CLAUDE_MEMORY_BRIDGE: "${CLAUDE_MEMORY_BRIDGE:-}"
      CLAUDE_MEMORY_LINE_BUDGET: "${CLAUDE_MEMORY_LINE_BUDGET:-}"
      CLAUDE_PROJECT_PATH: "${CLAUDE_PROJECT_PATH:-}"
      AGENTMEMORY_SUPPRESS_COST_WARNING: "${AGENTMEMORY_SUPPRESS_COST_WARNING:-}"
      AGENTMEMORY_TOOLS: "${AGENTMEMORY_TOOLS:-}"
      FALLBACK_PROVIDERS: "${FALLBACK_PROVIDERS:-}"
      OPENAI_API_VERSION: "${OPENAI_API_VERSION:-}"
      OPENAI_REASONING_EFFORT: "${OPENAI_REASONING_EFFORT:-}"
      OPENAI_TIMEOUT_MS: "${OPENAI_TIMEOUT_MS:-}"
      MINIMAX_BASE_URL: "${MINIMAX_BASE_URL:-}"
      OPENROUTER_EMBEDDING_MODEL: "${OPENROUTER_EMBEDDING_MODEL:-}"
      OPENROUTER_EMBEDDING_DIMENSIONS: "${OPENROUTER_EMBEDDING_DIMENSIONS:-}"
      AGENTMEMORY_LLM_TIMEOUT_MS: "${AGENTMEMORY_LLM_TIMEOUT_MS:-}"
      AGENTMEMORY_CAPTURE_MAX_ATTEMPTS: "${AGENTMEMORY_CAPTURE_MAX_ATTEMPTS:-}"
      AGENTMEMORY_CAPTURE_RETRY_INTERVAL_MS: "${AGENTMEMORY_CAPTURE_RETRY_INTERVAL_MS:-}"
      AGENTMEMORY_CAPTURE_DEDUP_HOURS: "${AGENTMEMORY_CAPTURE_DEDUP_HOURS:-}"
      AGENTMEMORY_CAPTURE_INBOX_MAX: "${AGENTMEMORY_CAPTURE_INBOX_MAX:-}"
      AGENTMEMORY_CAPTURE_DEAD_MAX: "${AGENTMEMORY_CAPTURE_DEAD_MAX:-}"
      AGENTMEMORY_CAPTURE_EVENTS_MAX: "${AGENTMEMORY_CAPTURE_EVENTS_MAX:-}"
      AGENTMEMORY_CAPTURE_SPOOL: "${AGENTMEMORY_CAPTURE_SPOOL:-}"
      AGENTMEMORY_CAPTURE_SPOOL_DIR: "${AGENTMEMORY_CAPTURE_SPOOL_DIR:-}"
      AGENTMEMORY_CAPTURE_SPOOL_MAX_BYTES: "${AGENTMEMORY_CAPTURE_SPOOL_MAX_BYTES:-}"
      AGENTMEMORY_CAPTURE_SPOOL_MAX_AGE_HOURS: "${AGENTMEMORY_CAPTURE_SPOOL_MAX_AGE_HOURS:-}"
      AGENTMEMORY_IMPORT_ROOT: "${AGENTMEMORY_IMPORT_ROOT:-}"
      AGENTMEMORY_EXPORT_ROOT: "${AGENTMEMORY_EXPORT_ROOT:-}"
      AGENTMEMORY_GRAPH_WEIGHT: "${AGENTMEMORY_GRAPH_WEIGHT:-}"
      SUMMARIZE_CHUNK_SIZE: "${SUMMARIZE_CHUNK_SIZE:-}"
      SUMMARIZE_CHUNK_CONCURRENCY: "${SUMMARIZE_CHUNK_CONCURRENCY:-}"
      CONSOLIDATION_DECAY_DAYS: "${CONSOLIDATION_DECAY_DAYS:-}"
      CONSOLIDATION_INTERVAL_MS: "${CONSOLIDATION_INTERVAL_MS:-}"
      AGENTMEMORY_CONSOLIDATION_COOLDOWN_MS: "${AGENTMEMORY_CONSOLIDATION_COOLDOWN_MS:-}"
      AGENTMEMORY_FOLLOWUP_WINDOW_SECONDS: "${AGENTMEMORY_FOLLOWUP_WINDOW_SECONDS:-}"
      GRAPH_EXTRACTION_BATCH_SIZE: "${GRAPH_EXTRACTION_BATCH_SIZE:-}"
      AGENTMEMORY_LLM_NOTHINK: "${AGENTMEMORY_LLM_NOTHINK:-}"
      AGENTMEMORY_REFLECT: "${AGENTMEMORY_REFLECT:-}"
      AGENTMEMORY_IMAGE_EMBEDDINGS: "${AGENTMEMORY_IMAGE_EMBEDDINGS:-}"
      AGENTMEMORY_IMAGE_STORE_MAX_BYTES: "${AGENTMEMORY_IMAGE_STORE_MAX_BYTES:-}"
      AGENTMEMORY_AUDIT_INDEX_PERSIST: "${AGENTMEMORY_AUDIT_INDEX_PERSIST:-}"
      AGENTMEMORY_INDEX_SAVE_INTERVAL_MS: "${AGENTMEMORY_INDEX_SAVE_INTERVAL_MS:-}"
      AGENTMEMORY_VECTOR_BUCKET_SIZE: "${AGENTMEMORY_VECTOR_BUCKET_SIZE:-}"
      AGENTMEMORY_VECTOR_BACKFILL_MAX: "${AGENTMEMORY_VECTOR_BACKFILL_MAX:-}"
      AGENTMEMORY_VECTOR_BACKFILL: "${AGENTMEMORY_VECTOR_BACKFILL:-}"
      AGENTMEMORY_SLOTS: "${AGENTMEMORY_SLOTS:-}"
      AGENTMEMORY_PROVIDER: "${AGENTMEMORY_PROVIDER:-}"
      AGENTMEMORY_VERBOSE: "${AGENTMEMORY_VERBOSE:-}"
      OBSIDIAN_AUTO_EXPORT: "${OBSIDIAN_AUTO_EXPORT:-}"
      AUTO_FORGET_ENABLED: "${AUTO_FORGET_ENABLED:-}"
      AUTO_FORGET_INTERVAL_MS: "${AUTO_FORGET_INTERVAL_MS:-}"
      LESSON_DECAY_ENABLED: "${LESSON_DECAY_ENABLED:-}"
      INSIGHT_DECAY_ENABLED: "${INSIGHT_DECAY_ENABLED:-}"
      REBUILD_EMBED_BATCH_SIZE: "${REBUILD_EMBED_BATCH_SIZE:-}"
      RERANK_ENABLED: "${RERANK_ENABLED:-}"
      PATH: /usr/local/bin:/usr/bin:/bin
      MALLOC_ARENA_MAX: "2"