Skip to main content

Lattice AI — local-first Living Brain workspace: conversation, durable memory, hybrid search, real agent/workflow runtimes, advanced graph exploration, and portable encrypted brain archives

Project description

Lattice AI

PyPI Version npm Version VS Code Marketplace Version Open VSX Version CI Status License

Lattice AI v4.6.1 is the local-first Living Brain release refresh. It keeps the v4 Brain Core, StorageEngine, FastAPI localhost API, Tauri shell, backup, restore, model runtime, graph, and portability architecture intact while making the release/publishable version 4.6.1 after the v4.6.0 PyPI immutability block.

The product opens with a private local profile, studies the computer, recommends models, asks before install/download/load work, then lands in Brain Chat. The graph is still real and searchable, but it now grows out of the Brain as the deepest exploration layer instead of acting like a separate dashboard.

External package registries are owner-published and can lag behind this GitHub Release. Release uploads must use the exact v4.6.1 artifact filenames below.

Living Brain Flow

1. Login

First launch opens to Login only. The local profile is the beginning of the Brain, not a dashboard, graph, or setup grid.

Login

2. Environment Analysis

Lattice reads the machine locally and summarizes what kind of Brain this computer can support.

Environment Analysis

3. Recommended Models

The model step is a short recommendation list. It avoids catalog noise and keeps runtime/install details behind clear user consent.

Recommended Models

4. Install And Load

The install screen keeps consent visible and shows install, download, validate, and load progress. No model download or runtime install starts silently.

Install and Load

5. Brain Chat

After setup, the home experience is the living Brain plus conversation. The Brain stays present while the user types, recalls context, and receives responses.

Brain Chat Home

Brain Depths

The user travels inward through the Brain. Each depth keeps conversation nearby while revealing more structure.

Depth Experience Evidence
Level 1 Living Brain presence Living Brain Level 1
Level 2 Memory Layer Memory Layer
Level 3 Knowledge Layer Knowledge Layer
Level 4 Relationship Layer Relationship Layer
Level 5 Knowledge Graph with nodes, edges, search, and focus detail Knowledge Graph Layer

Walkthrough:

v4.6.1 Living Brain walkthrough

Model setup status evidence:

Model setup status

Screenshot index and capture notes: output/release/v4.6.1/SCREENSHOT_INDEX.md

Architecture At A Glance

  • Desktop shell: Tauri 2 is the release desktop shell and starts the localhost sidecar.
  • Frontend: React, TypeScript, Vite, TanStack Query, Zustand, Cytoscape.js, React Flow, Tailwind/shadcn-style primitives, and generated OpenAPI types.
  • Backend: FastAPI on localhost is the UI source of truth.
  • Brain Core: independent lattice_brain package for graph, memory, context, conversations, ingestion, runtime, workflow, storage, and portability. Isolation tests prevent lattice_brain from importing latticeai.
  • Storage: StorageEngine abstraction with SQLite default and optional PostgreSQL/pgvector scale mode.
  • Portability: encrypted .latticebrain archives plus backup, restore, inspect, verify, import dry-run, and confirmed restore/import flows.
  • Privacy: local-first and private-first by default. Cloud models, Telegram, Brain Network, Docker/Postgres setup, model downloads, and update checks are opt-in paths.

See ARCHITECTURE.md for the detailed v4.6.1 architecture.

Installation

Run from Python:

pip install ltcai
LTCAI

Run from npm:

npm install -g ltcai
ltcai

Open the local app:

http://127.0.0.1:4825/app

Apple Silicon local model extras:

pip install "ltcai[local]"

Release Artifacts

Validated v4.6.1 artifacts:

  • dist/ltcai-4.6.1-py3-none-any.whl
  • dist/ltcai-4.6.1.tar.gz
  • ltcai-4.6.1.tgz
  • dist/ltcai-4.6.1.vsix
  • src-tauri/target/release/bundle/dmg/Lattice AI_4.6.1_aarch64.dmg

Attach only those exact files to the GitHub Release. Do not upload dist/*.

Local Development

npm install
npm run dev

Build and validate release artifacts:

npm run release:artifacts
npm run release:validate

Main validation set:

npm run check:python
node scripts/run_python.mjs -m ruff check .
npm run lint
npm run typecheck
npm run test:unit
npm run test:integration
npm run test:visual
npm run desktop:tauri:check
node scripts/run_python.mjs scripts/wheel_smoke.py --wheel dist/ltcai-4.6.1-py3-none-any.whl
npm pack --dry-run
npm run docs:check-links

Known Limitations

  • External package registries are owner-published and can lag behind the GitHub Release.
  • PostgreSQL/pgvector is optional scale mode. SQLite is the default local brain.
  • Docker, model downloads, cloud model calls, Telegram, Brain Network, and update checks require explicit user action.
  • Conversation does not fabricate answers when no model is loaded.
  • Agent/workflow simulation without a loaded LLM is deterministic and does not call a model. It is labeled as LLM-free/model-free rather than presented as autonomous model success.
  • Historical artifacts can remain in dist/; uploads must use exact v4.6.1 filenames.

Release History

Version Theme
4.6.1 Living Brain Release Refresh: publishable version bump after v4.6.0 PyPI immutability, refreshed README/screenshots/GIFs, synchronized release docs, and exact v4.6.1 artifacts
4.6.0 Living Brain Experience: made Brain plus conversation the home product, added an animated living Brain presence, and moved graph exploration to the deepest intentional layer
4.5.1 Product Reimagining RC: replaced the desktop shell, navigation model, onboarding journey, first-viewport hierarchy, and visual system while preserving capabilities and local-first architecture
4.5.0 Product Experience Recovery RC: restored first-run setup, workspace/model onboarding, explicit model install/download/validate/load flow, Gemma 4 runtime compatibility gating, Basic-mode polish, and graph discoverability
4.4.0 Brain Engine Extraction: Brain Core physically moved into lattice_brain with isolation tests
4.3.3 Dead-Code Cleanup Release
4.3.2 Product Polish & Graph UX Overhaul RC
4.3.1 End-User Audit Repair RC
4.3.0 Portability & Product Hardening RC
4.2.0 Brain Core & Storage Rebuild
4.1.0 Frontend & Desktop Rebuild
4.0.1 Digital Brain maintenance
4.0.0 Digital Brain Platform foundation
3.0.0 v3 local-first AI workspace platform

Current Documentation

License

MIT. See LICENSE.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ltcai-4.6.1.tar.gz (2.1 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ltcai-4.6.1-py3-none-any.whl (2.0 MB view details)

Uploaded Python 3

File details

Details for the file ltcai-4.6.1.tar.gz.

File metadata

  • Download URL: ltcai-4.6.1.tar.gz
  • Upload date:
  • Size: 2.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.5

File hashes

Hashes for ltcai-4.6.1.tar.gz
Algorithm Hash digest
SHA256 cb04e7b905fa7de998688970caf8b126ed83587766bd2f627fdb5346276cc287
MD5 09e47c2c4ede819e8228a807152c8635
BLAKE2b-256 d85d3387864a7e188cd422a214d6b7a1ea38d964abc6c30bb28daae1d7e672d4

See more details on using hashes here.

File details

Details for the file ltcai-4.6.1-py3-none-any.whl.

File metadata

  • Download URL: ltcai-4.6.1-py3-none-any.whl
  • Upload date:
  • Size: 2.0 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.5

File hashes

Hashes for ltcai-4.6.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4e7d313741f7f45d8fef94c674d8269a9aa903fbc5335d550994029549c870c0
MD5 f4aed5cc8a1dc0e0c7f1caffd94d0944
BLAKE2b-256 6d5ba6c8921e8fc4311543469379c7344bf34365b3e7e4543e67c674f08ac814

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page