Skip to content

README.md

Latest commit

 

History

History
110 lines (89 loc) · 3.39 KB

README.md

File metadata and controls

110 lines (89 loc) · 3.39 KB

Flow Memory

Flow Memory is an open-source autonomous AI agent operating system and local/testnet-ready agent economy prototype.

The project now combines:

  • FlowLang v0 agent declarations
  • FlowIR manifests
  • first-class AI agent profiles/state/goals/planning/execution
  • layered memory and constitutional memory governance
  • safe skill/tool execution seams
  • local Economy V3 marketplace, escrow, settlement, disputes, slashing, reputation, receipts
  • signed manifest/receipt/provenance prototypes
  • SQLite durable storage
  • internal API router and optional server seams
  • Base Sepolia / ERC-4337 dry-run adapters
  • sandbox hardening interfaces
  • MCP/A2A/libp2p protocol seams
  • dashboard scaffold and CI workflows

Flow Memory is production-shaped, not production-certified. It does not claim audited contracts, hardened sandboxing, mainnet readiness, or trained ML model performance.

Install

PowerShell:

cd E:\FlowMemory\flow-memory
.\.venv\Scripts\python.exe -m pip install -e ".[dev]"

If no virtual environment exists:

py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip
.\.venv\Scripts\python.exe -m pip install -e ".[dev]"

Validate

.\.venv\Scripts\python.exe -m pytest -q
.\.venv\Scripts\python.exe examples\flowlang_compile_demo.py
.\.venv\Scripts\python.exe examples\flowlang_runtime_demo.py
.\.venv\Scripts\python.exe examples\flowlang_economy_demo.py
.\.venv\Scripts\python.exe -m flow_memory --json "Explore and report"
.\.venv\Scripts\python.exe -m flow_memory --flow examples\flowlang_agent.flow --json "Run the declared agent"
bash scripts/verify.sh
.\.venv\Scripts\python.exe scripts\generate_deployment_plan.py
.\.venv\Scripts\python.exe scripts\base_sepolia_dry_run.py
docker compose config
forge build
forge test
git diff --check

Observed during the V3 build:

  • Python tests: 184 passed
  • FlowLang compile demo: passed
  • FlowLang runtime demo: passed
  • FlowLang economy demo: passed
  • CLI smoke: passed
  • CLI --flow: passed
  • deployment dry-run scripts: passed

Run FlowLang agent

.\.venv\Scripts\python.exe -m flow_memory --flow examples\flowlang_agent.flow --json "Run the declared agent"

Run examples

.\.venv\Scripts\python.exe examples\agent_profile_demo.py
.\.venv\Scripts\python.exe examples\agent_economy_v3_demo.py
.\.venv\Scripts\python.exe examples\agent_dispute_slashing_demo.py
.\.venv\Scripts\python.exe examples\signed_manifest_demo.py
.\.venv\Scripts\python.exe examples\storage_persistence_demo.py

Important docs

  • docs/AI_AGENT_LAYER.md
  • docs/AGENT_ECONOMY_V3.md
  • docs/FLOWLANG_RUNTIME_INTEGRATION.md
  • docs/STORAGE.md
  • docs/SIGNED_MANIFESTS.md
  • docs/API_SERVER.md
  • docs/WEB3_ADAPTERS.md
  • docs/BASE_SEPOLIA_DEPLOYMENT.md
  • docs/SANDBOX_HARDENING.md
  • docs/PROTOCOL_GATEWAYS.md
  • docs/THREAT_MODEL.md
  • docs/PRODUCTION_READINESS.md
  • BUILD_REPORT.md
  • FLOW_MEMORY_STATUS.md

Honest limitations

  • FlowLang remains v0/prototype.
  • Economy V3 is local/testnet-ready architecture, not a live funds system.
  • Contracts are unaudited.
  • Signing uses local development HMAC by default.
  • Base Sepolia scripts produce dry-run payloads only.
  • Sandbox hardening is an interface and policy layer; it is not hardened VM/container isolation.
  • Protocol gateways are local/offline-safe seams, not production transports.
  • Dashboard is a scaffold with mock data.