liven 0.1.0

LIVEN is a fast, lightweight database built to capture, store, and stream data in real time.
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

[server]
environment = "development"
host = "127.0.0.1"
db_port = 43121
webui_port = 43120
max_connections = 10000
broadcast_capacity = 4096


[security]
mode = "auth_key" # Options: "auth_key", "none"

[security.auth_key]
system_stream = "auth_keys"
allow_local_auto_generation = true


[storage]
data_directory = "./data"

[limits]
# Maximum concurrent streams. Each stream has its own timestamp index.
max_concurrent_streams = 32

# Open file descriptor cache for segment files.
# Increase if you have many segments and frequent cold reads.
max_open_file_descriptors = 64

# Index RAM budget in megabytes.
# If not explicitly set, LIVEN auto-allocates 25% of system RAM (max 4GB).
# Formula: ~84 bytes per unique key.
# Examples at different budgets:
# - 16MB ≈ 190K keys (legacy default)
# - 64MB ≈ 760K keys
# - 256MB ≈ 3M keys
# - 1GB ≈ 12M keys
# - 4GB ≈ 48M keys (max auto-detected)
# Uncomment to override auto-detection with a specific value:
# max_index_ram_mb = 256

# Maximum segment file size before a new segment is created.
max_segment_size_mb = 16

# Maximum number of records returned from full scan operations
max_scan_results = 100000

# ============================================
# RECOMMENDED CONFIGURATION PROFILES
# ============================================
# Uncomment and adjust the following profiles based on your deployment scenario.
# These are NOT active TOML sections - they are examples only.

# --- Edge/Embedded Profile ---
# For resource-constrained devices (Raspberry Pi, IoT)
# [limits]
# max_concurrent_streams = 8
# max_open_file_descriptors = 16
# max_index_ram_mb = 32  # Override auto-detect for small devices
# max_scan_results = 10000

# --- Development Profile ---
# For local development with auto-detection
# [server]
# environment = "development"
# host = "127.0.0.1"
# [security]
# mode = "none"  # Auto-disabled for development

# --- Production Profile ---
# For server deployments
# [server]
# environment = "production"
# host = "0.0.0.0"
# [security]
# mode = "auth_key"  # Auto-enabled for production
# [security.auth_key]
# allow_local_auto_generation = false

# --- High-Volume Profile ---
# For systems with many streams and high throughput
# [limits]
# max_concurrent_streams = 64
# max_open_file_descriptors = 128
# max_scan_results = 500000