engram-core 0.15.0

AI Memory Infrastructure - Persistent memory for AI agents with semantic search
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

# Engram Configuration Example
# Copy this file to .env.local and fill in your values
# DO NOT commit .env.local to version control

# =============================================================================
# Database Configuration
# =============================================================================
# Path to SQLite database file (supports ~ expansion)
ENGRAM_DB_PATH=~/.local/share/engram/memories.db

# =============================================================================
# Cloud Sync (Optional)
# =============================================================================
# S3-compatible storage URI for cloud sync
# Examples:
#   AWS S3:       s3://my-bucket/engram/memories.db
#   Cloudflare R2: s3://my-bucket/engram.db
#   MinIO:        s3://my-bucket/data/engram.db
ENGRAM_STORAGE_URI=

# Enable AES-256 encryption for cloud storage
ENGRAM_CLOUD_ENCRYPT=false

# =============================================================================
# Cloudflare R2 Configuration (if using R2)
# =============================================================================
# Get these from: https://dash.cloudflare.com/<account>/r2/api-tokens
CLOUDFLARE_ACCOUNT_ID=
R2_ACCESS_KEY_ID=
R2_SECRET_ACCESS_KEY=
R2_ENDPOINT_URL=https://<account_id>.r2.cloudflarestorage.com

# =============================================================================
# AWS Configuration
# =============================================================================
# AWS profile name (from ~/.aws/credentials)
AWS_PROFILE=

# Custom S3 endpoint (for R2, MinIO, or other S3-compatible services)
AWS_ENDPOINT_URL=

# Or use explicit credentials (not recommended, use AWS_PROFILE instead)
# AWS_ACCESS_KEY_ID=
# AWS_SECRET_ACCESS_KEY=
# AWS_REGION=auto

# =============================================================================
# Embedding Configuration (Optional)
# =============================================================================
# Embedding model: "tfidf" (default), "openai"
ENGRAM_EMBEDDING_MODEL=tfidf

# OpenAI API key (required if using openai embeddings)
OPENAI_API_KEY=

# =============================================================================
# External Services (Optional)
# =============================================================================

# =============================================================================
# Linear API (Optional - for project management integration)
# =============================================================================
LINEAR_API_KEY=