memvid-cli 2.0.106

Command-line interface for Memvid v2 - AI memory with crash-safe, single-file storage
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

# memvid-cli

Command-line interface for Memvid v2 - AI memory with crash-safe, single-file storage.

## Installation

```bash
cargo install memvid-cli
```

Or with specific features:

```bash
# Without llama.cpp (for Docker/ARM emulation)
cargo install memvid-cli --no-default-features --features temporal_track,temporal_enrich,parallel_segments,candle-llm

# With Metal acceleration (macOS)
cargo install memvid-cli --features metal

# With audio playback
cargo install memvid-cli --features audio-playback
```

## Quick Start

```bash
# Create a new memory file
memvid create journal.mv2

# Add content
memvid put journal.mv2 --input document.pdf --embeddings
memvid put journal.mv2 --input notes/ --embeddings

# Search
memvid find journal.mv2 --query "meeting notes" --json

# Q&A with retrieval
memvid ask journal.mv2 --question "What was discussed in the Q3 review?"

# Timeline queries
memvid timeline journal.mv2 --since 1706745600 --limit 10

# View a specific frame
memvid view journal.mv2 --frame-id 3 --json
```

## Commands

| Command | Description |
|---------|-------------|
| `create` | Create a new .mv2 memory file |
| `put` | Ingest content (files, directories, URLs) |
| `find` | Search with lexical or semantic queries |
| `ask` | Q&A with retrieval-augmented generation |
| `timeline` | Query frames by time range |
| `view` | Display frame content and metadata |
| `update` | Modify frame metadata |
| `delete` | Remove frames by URI or ID |
| `verify` | Check file integrity |
| `doctor` | Repair and rebuild indices |
| `stats` | Show memory statistics |
| `tickets` | Manage capacity tickets |

## Features

- **Single File**: Everything in one portable `.mv2` file
- **Crash Safe**: Embedded WAL ensures data durability
- **Hybrid Search**: Lexical (Tantivy) + Semantic (HNSW) search
- **Multi-Format**: PDF, DOCX, XLSX, images, audio, video
- **Local LLM**: Built-in Q&A with Phi-3 or llama.cpp
- **Timeline**: Time-based document organization
- **Offline**: Works completely offline after model download

## Environment Variables

| Variable | Description |
|----------|-------------|
| `MEMVID_MODELS_DIR` | Model cache directory (default: `~/.memvid/models`) |
| `MEMVID_OFFLINE` | Skip model downloads (use cached) |
| `MEMVID_API_URL` | Control plane endpoint |
| `MEMVID_API_KEY` | API authentication key |

## License

Apache-2.0

## Links

- [Documentation](https://docs.memvid.com)
- [GitHub](https://github.com/memvid/memvid)