Generated banner for spector
Generated logo for spector

spector

Memory frameworkOfficial Spectrayan project

Created by Spectrayan

Published in spectrayan/spector. Publisher page

26 GitHub stars

What it is

Memory backbone for AI agents. Four-tier store — working, episodic, semantic, procedural — with decay, consolidation, and association graphs. Fused semantic + SIMD-accelerated hybrid recall, in-process MCP, REST/gRPC, and language SDKs.
— the description by Spectrayan

Summary from the brain’s metadata

Memory backbone for AI agents. Four-tier store — working, episodic, semantic, procedural — with decay, consolidation, and association graphs. Fused semantic + SIMD-accelerated hybrid recall, in-process MCP, REST/gRPC, and language SDKs.

How it works

Memory model: Vector store

AutoGineer overview, from the brain’s own files

Memory model: Vector store. Folders: .github (agent config, 26 files); .kiro (agent config, 5 files); docs (docs, 325 files); examples (examples, 3 files); memory (memory, 1418 files); scripts (scripts, 48 files); src (source code, 1 file).

Folders
FolderRoleFiles
.githubagent-config26
.kiroagent-config5
docsdocs325
examplesexamples3
memorymemory1418
scriptsscripts48
srcsource-code1
.aifolder1
Formulafolder1
benchfolder236
clusterfolder73
cortexfolder397
deployfolder58
nucleusfolder634
packagingfolder2
pluginsfolder23
sdksfolder818
synapsefolder1246

Requirements

Apps: Docker

API keys (by name): SPECTOR_API_KEY, SPECTOR_AUTH_JWT_SECRET, SPECTOR_EMBEDDING_API_KEY, SPECTOR_GENERATION_API_KEY

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Google Antigravity, Kiro, OpenCode, Amp, Roo Code, Cline, JetBrains Junie, Devin (ex-Windsurf)

Set it up

  1. This brain runs code automatically: 6 scripts. Review README.md, plugins/openclaw/install.ps1, plugins/openclaw/install.sh, scripts/install.ps1, scripts/install.sh before opening the folder in Claude Code. No step below turns a hook on for you.

    • README.md: curl -fsSL https://raw.githubusercontent.com/spectrayan/spector/main/scripts/install.sh | sh
    • README.md: irm https://raw.githubusercontent.com/spectrayan/spector/main/scripts/install.ps1 | iex
    • plugins/openclaw/install.ps1: pwsh plugins/openclaw/install.ps1
    • plugins/openclaw/install.sh: sh plugins/openclaw/install.sh
    • scripts/install.ps1: pwsh scripts/install.ps1
    • scripts/install.sh: sh scripts/install.sh
  2. Add spector to .mcp.json:

    {
      "mcpServers": {
        "spector": {
          "command": "npx",
          "args": [
            "-y",
            "@spectrayan/[email protected]",
            "mcp"
          ]
        }
      }
    }
    
  3. Or add it with the Claude Code CLI:

    claude mcp add spector -- npx -y @spectrayan/[email protected] mcp
  4. AutoGineer scanned exactly what this command runs: @spectrayan/[email protected], fetched by its integrity digest and pinned to the version AutoGineer scanned, with no third-party dependency.

  5. Not scanned by AutoGineerThe author’s README also describes installing it with Docker Compose. Read its install section: AutoGineer did not scan that path. https://github.com/spectrayan/spector/blob/17928345e7de1ce3278a5f849fdf2ee737fc1540/README.md#1-zero-install-mcp-server-for-ai-agents
  6. Created by Spectrayan. Published in spectrayan/spector. Licence: Apache License 2.0.

Usage

AutoGineer’s guidance for this type of brain

Install the library in your own agent code and call it to store and retrieve memories; see its documentation for the API.

Documentation by Spectrayan

A licence file holds personal contact details, so AutoGineer links to the files instead of copying them. Read the documentation at the source

512 files · 512 not served here

Advantages

  • Local-first: the memory stays in files or a database on your own machine (a rule-derived fact from the brain’s files, evidence: README.md)
  • Works with 14 MCP clients (a rule-derived fact from the brain’s files, evidence: README.md)
  • Open licence (Apache-2.0) (a rule-derived fact from the brain’s files)

Limitations

  • Needs an API key (SPECTOR_API_KEY, SPECTOR_AUTH_JWT_SECRET, SPECTOR_EMBEDDING_API_KEY) (a rule-derived fact from the brain’s files, evidence: README.md)
  • Runs code automatically: review what it runs before you open it (a rule-derived fact from the brain’s files)
  • Link-only: AutoGineer links to the files instead of serving them (a rule-derived fact from the brain’s files)

Security

Risk level: Medium risk

This brain runs

Agent instructions that run or fetch something (13)

  • .kiro/steering/tech.md: # Run all tests
  • .kiro/steering/tech.md: # Install all modules locally (needed first time for dep resolution)
  • .kiro/steering/tech.md: mvn clean install -Psynapse -DskipTests
  • .kiro/steering/tech.md: # Run the MCP server
  • .kiro/steering/tech.md: npm start # Dev server
  • .kiro/steering/tech.md: npm run build # Production build
  • .kiro/steering/tech.md: npm test # Run tests (Vitest)
  • .kiro/steering/tech.md: python -m mkdocs build --clean # Build docs site
  • .kiro/steering/tech.md: python -m mkdocs serve # Local dev server
  • .kiro/steering/tech.md: All commits require `Signed-off-by` line (`git commit -s`)
  • AGENTS.md: # Run unit tests on spector-memory core
  • AGENTS.md: node scratch/validate_mermaid.js
  • AGENTS.md: Always sign off with DCO 1.1 (`git commit -s`).

MCP servers (3)

  • README.md (spector): npx -y @spectrayan/spector mcp
  • README.md (spector): npx -y @spectrayan/spector mcp
  • README.md (spector): npx -y @spectrayan/spector mcp

Install scripts (6)

  • README.md: curl -fsSL https://raw.githubusercontent.com/spectrayan/spector/main/scripts/install.sh | sh · uses the network
  • README.md: irm https://raw.githubusercontent.com/spectrayan/spector/main/scripts/install.ps1 | iex · uses the network
  • plugins/openclaw/install.ps1: pwsh plugins/openclaw/install.ps1 · uses the network
  • plugins/openclaw/install.sh: sh plugins/openclaw/install.sh · uses the network
  • scripts/install.ps1: pwsh scripts/install.ps1 · uses the network
  • scripts/install.sh: sh scripts/install.sh · uses the network
  • Medium risk: runs-install-script-remote-exec (README.md:96)
  • Medium risk: runs-install-script-remote-exec (README.md:99)
  • Medium risk: runs-mcp-server-unpinned-runner (README.md:112)
  • Medium risk: runs-mcp-server-unpinned-runner (README.md:125)
  • Medium risk: runs-mcp-server-unpinned-runner (README.md:138)
  • Medium risk: runs-install-script-network-variable-host (scripts/install.ps1)
  • Medium risk: network-variable-host (scripts/install.ps1:134)
  • Medium risk: network-variable-host (scripts/install.ps1:139)
  • Medium risk: runs-install-script-network-variable-host (scripts/install.sh)
  • Medium risk: network-variable-host (scripts/install.sh:144)
  • Medium risk: network-variable-host (scripts/install.sh:149)
  • Low risk: scripts-present (plugins/openclaw/install.ps1)
  • Low risk: scripts-present (plugins/openclaw/install.sh)
  • Low risk: scripts-present (scripts/install.ps1)
  • Low risk: scripts-present (scripts/install.sh)

AutoGineer scanned @spectrayan/[email protected] (sha512-ZiOuvsvIsMyet2bQGoZbgPcsTIDiJ6eJujFpb5bEvwXOkPM7XjN6hxFNBuCilBxjGMyc3MZian3PFl0mbMsMvw==).

Attribution and licence

Created by
Spectrayan
Publisher
Spectrayan (Official Spectrayan project)
Source
spectrayan/spector · commit 1792834
Licence
Apache License 2.0 (A licence file holds personal contact details, so AutoGineer links to the files instead of copying them.)
Synced

AutoGineer is not affiliated with or endorsed by Spectrayan.

Install from source

A licence file holds personal contact details, so AutoGineer links to the files instead of copying them. spectrayan/spector at 1792834