⚠️ IMPORTANT: All features are experimental, under active development. Use at your own risk. Customization to your workflow required. © 2026 GLG, a.s. | ← Back to Index

3. Core API Reference

3.1 Facade API (Recommended)

The simplest way to use UAML. One import, all features:

from uaml.facade import UAML

uaml = UAML()

Store Knowledge

uaml.learn(
    content="Python 3.13 removed the GIL",
    topic="python",           # optional category
    source_type="research",   # optional: chat, research, observation, manual
    confidence=0.95           # 0.0–1.0, default 0.8
)

Search

results = uaml.search(
    query="Python threading",
    limit=10,                 # max results
    topic="python"            # optional filter
)
for entry in results:
    print(entry.content, entry.confidence, entry.created_at)

Recall with Focus Engine (Starter+)

context = uaml.recall(
    query="What do I know about Python?",
    budget_tokens=1000,       # token budget for context
    tier="professional"       # applies tier-specific filtering
)

Audit Report

report = uaml.audit_report()
# Returns: who stored what, when, access patterns

3.2 REST API (Dashboard)

The UAML Dashboard exposes a REST API on port 8780 (default):

Method	Endpoint	Description
GET	/api/health	Health check
GET	/api/stats	Memory statistics
GET	/api/knowledge	List memories (?limit=&offset=)
GET	/api/knowledge/<id>	Get single entry
POST	/api/knowledge	Store memory ({content, source, ...})
GET	/api/v1/focus-config	Current Focus Engine config
PUT	/api/v1/focus-config	Update Focus Engine config
GET	/api/v1/focus-config/presets	List available presets
POST	/api/v1/focus-recall	Focus-aware recall ({query, budget, tier})

Example: Store via REST

curl -X POST http://localhost:8780/api/knowledge \
  -H "Content-Type: application/json" \
  -d '{"content": "Meeting moved to Thursday", "source": "calendar"}'

Example: Recall via REST

curl -X POST http://localhost:8780/api/v1/focus-recall \
  -H "Content-Type: application/json" \
  -d '{"query": "upcoming meetings", "budget": 500}'

3.3 CLI

uaml learn "The server IP is 10.0.0.1"
uaml search "server IP"
uaml recall "What servers do we have?" --budget 500
uaml stats
uaml export --format jsonl --output backup.jsonl
uaml import --file backup.jsonl

---