Strata

휴대용 에이전트 메모리. 추가 전용 레코드, 검증된 출처, MCP 도구, 셀프 호스팅.

Strata는 팀에게 프로젝트를 섞지 않고, 비밀을 누출하지 않으며, 기록을 다시 쓰지 않으면서도 모든 에이전트가 읽고 업데이트할 수 있는 하나의 지속적인 메모리를 제공합니다. 사람, 세션, 머신, 런타임을 넘나드는 작업을 위해 설계되었습니다.

존재 이유

로컬 에이전트 메모리는 작업이 머신, 사람, 도구, 또는 오래된 세션을 넘나들 때 깨집니다. Strata는 단일 에이전트 실행을 넘어 지속되어야 할 사실들을 보관합니다:

• 실험 결과와 결정 사항;

• 데이터셋 노트, 소스 체크섬, 추출 상태;

• 효과가 있었던 절차와 피해야 할 실수;

• 나중에 합류하는 에이전트를 위한 프로젝트 인수인계.

Strata는 비밀, 원본 대화 기록, chain-of-thought, API 키, 또는 공급자 설정을 저장하지 않습니다.

Related MCP server: memhippo

구성 요소

빠른 시작

git clone https://github.com/rx6ru/strata.git
cd strata
python -m venv .venv
. .venv/bin/activate
python -m pip install -e .
strata --help

로컬 게이트웨이를 시작합니다:

strata serve --root /tmp/strata-demo --host 127.0.0.1 --port 8787

다른 셸에서 확인합니다:

curl -fsS http://127.0.0.1:8787/healthz
curl -fsS -H 'X-Strata-Client: 1' http://127.0.0.1:8787/v1/status

패키지를 설치하기 전에 소스 체크아웃에서 실행하는 경우:

PYTHONPATH=. python -m strata --help
PYTHONPATH=. python -m strata root-hash --root /tmp/strata-demo

전체 설정 가이드는 docs/getting-started.md에서 읽으세요.

에이전트가 사용하는 방법

1. skills/strata/를 에이전트 런타임 스킬 디렉터리에 복사합니다.

2. 에이전트에게 게이트웨이 URL, 네임스페이스, 현재 작업, SSH 별칭, 선택적 수명주기 래퍼 경로와 같은 비밀이 아닌 런타임 값만 제공합니다.

3. 에이전트는 정책을 가져오고, 범위가 제한된 컨텍스트를 준비하고, 정식 레코드를 읽고, 검증된 지속 지식만 작성합니다.

4. 수정 사항은 대체 레코드를 추가합니다. 재구성은 위치 이동, 분할, 병합, 또는 무효화 이벤트를 추가합니다. 일반 에이전트는 기록을 제자리에서 편집하지 않습니다.

스킬은 호스트 이름, IP 주소, EC2 인스턴스 ID, 사용자 이름, API 키, 프로젝트 네임스페이스, 정책 해시, 루트, 또는 레코드 ID를 하드코딩하지 않습니다. docs/agent-skill.md를 참조하세요.

쓰기가 깨끗하게 유지되는 방법

Strata는 커밋 전에 모든 쓰기를 검사합니다:

• 커밋 전에 현재 정책 해시가 확인됩니다;

• 스키마가 레코드를 검증합니다;

• 멱등성 키가 중복 재시도를 방지합니다;

• 추가 전용 SQLite 트리거가 제자리 기록 편집을 차단합니다;

• 콘텐츠 해시와 루트 매니페스트가 내보내기를 검증 가능하게 만듭니다;

• 비밀 및 원본 대화 스캐너가 안전하지 않은 페이로드를 거부합니다;

• 파생된 회상은 진실이 아닌 탐색으로 표시됩니다.

셀프 호스팅

Docker 스택의 경우:

./scripts/configure.sh
./scripts/control.sh start

시스템 서비스의 경우 설치 가이드와 deploy/의 제한된 수명주기 래퍼를 사용하세요. 원격 에이전트는 status, start, stop, restart에 대해서만 해당 래퍼를 호출해야 합니다.

기본 배포에는 앱 수준 사용자가 없습니다. 루프백, 사설 네트워크, SSH, VPN, 방화벽, 또는 자체 프록시/인증 계층에서 유지하세요. 팀 호스팅 전에 docs/security-model.md와 SECURITY.md를 읽으세요.

REST 및 MCP

REST 게이트웨이는 /v1 아래에 health, policy, status, search, recall, record, append, supersede, relocate, split, merge, invalidate 엔드포인트를 노출합니다.

MCP 브리지는 memory_policy, memory_prepare_context, memory_search, memory_get, memory_capture_verified, memory_status와 같은 일치하는 도구를 노출합니다.

평가

PYTHONPATH=. python -m strata eval --input tests/fixtures/strata_eval/cases.json

픽스처는 네임스페이스 격리, 출처, 승격 및 거부 동작, 파생 회상 레이블, 금지 값 누출을 확인합니다.

라이선스

MIT. LICENSE를 참조하세요. 타사 고지 사항은 THIRD_PARTY_NOTICES.md에 있습니다.