Skip to main content

Lattice AI v3 local-first AI workspace platform with knowledge graph, vector index, hybrid search, agents, and workspace modes

Project description

Lattice AI

Lattice AI

Local-first AI workspace for your files, chats, knowledge, models, and agents.

Keep your work context on your own machine. Connect documents, conversations, local models, graph memory, and agent workflows in one self-hosted workspace.

PyPI version npm version VS Code Marketplace Open VSX GitHub release License: MIT Python 3.11+ VS Code extension

Lattice AI — local-first AI workspace home

Lattice AI is a self-hosted AI workspace that keeps your files, chats, knowledge, local models, and agents together on your own machine.

It isn't another chat window. It's a workspace built around your work — local-first by default, cloud only when you choose.

Why install Lattice AI?

Most AI tools only answer questions in a chat window. Lattice AI gives you a workspace around the work itself:

  • Keep everything in one place — files, notes, chats, and decisions live together instead of scattered across tabs and apps.
  • Turn documents into knowledge — uploads and connected folders become searchable, linked context you can reuse.
  • Search the way you think — fuse keyword, vector, and knowledge-graph signals in a single query.
  • Stay private and offline-capable — run local models through MLX, Ollama, or LM Studio; nothing leaves your machine unless you opt in.
  • Use cloud models only when you choose — bring an API key for cloud LLMs when you want them, not by default.
  • Automate with agents you can inspect — workflows leave behind plans, reviews, retries, and results you can replay.

Lattice AI is not a clone of ChatGPT, Claude, Cursor, Obsidian, or Notion. It sits in a different place: a workspace that ties local/self-hosted AI, your files, project knowledge, hybrid search, local and optional cloud models, agents, and workflows together — and runs on your own hardware.

What can you do with it?

  • Build a private AI workspace for a project, scoped to your machine.
  • Chat with your local files, images, and workspace memory.
  • Upload documents — or connect a folder — and turn them into searchable knowledge.
  • Explore how files, decisions, conversations, and entities connect in a Knowledge Graph.
  • Run local models through MLX, Ollama, or LM Studio, and use cloud LLMs only when you want to.
  • Create repeatable agent workflows for research, coding, analysis, and documentation.
  • Separate personal work from organization work.
  • Switch between Basic, Advanced, and Admin modes depending on your role.

Product Tour

Start from the workspace home

Lattice AI workspace home — readiness, model state, and retrieval status

The home view shows workspace readiness, model state, retrieval status, and the main entry points — derived from real local state, never placeholder counters.

Chat with files, images, and workspace context

Lattice AI chat connected to files, graph context, and vision input

Chat is wired to your files, graph context, memory, and model routing — including vision-capable image input by attach, drag-and-drop, or paste.

Bring documents into the workspace

Lattice AI files view — uploaded documents and connected folders

Uploads and connected folders become indexed workspace context, searchable from chat and hybrid search.

Understand knowledge visually

Lattice AI knowledge graph of files, decisions, conversations, and entities

The Knowledge Graph shows how files, decisions, conversations, and entities connect — context that stays useful even when you switch models.

Run agent workflows

Lattice AI agent run with roles, logs, review, and retry

Agents turn a goal into an inspectable run — roles, logs, review, and retry — that you can read back step by step.

Extend with hooks and the local runtime

Lattice AI hooks dispatch with a recent-execution log

Lattice AI local agent status, handshake, and folder watching

Advanced users wire lifecycle hooks into runs, tools, workflows, uploads, and indexing — and see the on-device local runtime's real status, handshake, and folder-watch activity.

Install

Install the local workspace:

pip install ltcai

Add Apple Silicon local model support:

pip install "ltcai[local]"

Install the npm CLI:

npm install -g ltcai

Install the coding extension:

Quick Start

Start the workspace:

LTCAI

Then open:

http://127.0.0.1:4825/app

Working from a development checkout:

npm install
npm run dev

Core Features

  • Local-first workspace — your data, models, and workspace state live on your machine by default; cloud is opt-in.
  • Files and connected folders — upload documents or connect a local folder; Lattice indexes them and watches connected folders for changes.
  • Chat with workspace context — conversations are grounded in your files, knowledge graph, and memory, with vision-capable image input.
  • Knowledge Graph — files, images, notes, conversations, and decisions become linked entities and relationships you can explore.
  • Hybrid Search — keyword, vector, and graph signals are fused into one ranked result set.
  • Local model support — run multimodal models locally via MLX, Ollama, or LM Studio, with hardware-aware recommendations and source disclosure.
  • Optional cloud model routing — add OpenAI-compatible or other cloud models when you choose; model cards disclose origin, run mode, and internet use.
  • Multi-agent workflows — turn goals into runs with roles, handoffs, review, retries, and replayable timelines.
  • Skills, hooks, tools, and MCP — extend the workspace with skills, lifecycle hooks, a governed tool registry, and Model Context Protocol servers.
  • Personal / Organization workspaces — keep personal work separate from team work with role-aware views.
  • Basic / Advanced / Admin modes — show only what each role needs, from core workflows to agent tooling to administration.

Latest Release

v3.4.1 — Runtime Completion

  • Full hooks lifecycle across HTTP, agent, workflow, upload, and indexing paths.
  • Real Local Agent probes instead of hardcoded readiness.
  • Connect Folder verified end-to-end.
  • Folder Watch verified, including restore after restart.

See RELEASE_NOTES_v3.4.1.md and FEATURE_STATUS.md.

How it works

files / chats / notes / images / decisions
  -> workspace memory
  -> knowledge graph
  -> hybrid search
  -> chat / agents / workflows
  -> reusable outputs
  • Your content stays on your machine and becomes durable workspace memory.
  • Memory is organized into a knowledge graph of entities and relationships.
  • Hybrid search fuses keyword, vector, and graph signals over that context.
  • Chat, agents, and workflows draw on the same grounded context.
  • Outputs — documents, analysis, and decisions — feed back into the workspace.

For the deeper design, see ARCHITECTURE.md and docs/architecture.md.

Documentation

Product and principles

Architecture

Knowledge and retrieval

Agents and workflows

Extensions

Releases

Release History

Version Theme
3.4.1 Runtime completion — full hooks lifecycle, real Local Agent probes, Connect Folder and Folder Watch verified end-to-end
3.4.0 Platform completion — hooks execution, uploads in Files, vision image input, agent run trigger, on-device Local Agent / Connect Folder / Folder Watch
3.3.1 Visual product rebuild — rebuilt /app shell, Basic/Advanced/Admin navigation, refreshed design system
3.3.0 Product quality & honesty release — evidence-based feature audit, single-source version truth, working document upload, documented design system
3.2.0 Feature-complete platform — multi-agent collaboration, agent registry, marketplace + templates, workflow agents, long-term memory, skills/hooks/tool registries, MCP manager
3.1.0 Mainline platform completion — native /app workflows, production embedding profiles, AgentRuntime/registries, hashed v3 assets
3.0.1 Release-blocker remediation — provider-backed embeddings, unified AgentRuntime boundary, every v3 surface connected or clearly unavailable
3.0.0 v3 local-first AI workspace platform — /app, Native Chat, Knowledge Graph, Vector Index, Hybrid Search, workspace modes
2.2.7 Visual system stabilization — cohesive dark/light screens, crisp chat composer, dark graph canvas, Workspace OS polish
2.2.6 Token-native CSS foundation
2.2.5 Release hygiene hotfix — dark overlays, modal stack, cache-busting, favicon, and Telegram log masking
2.2.4 Chat dark-mode completion
2.2.3 Frontend stability and UX fixes
2.2.2 Frontend QA stabilization — mobile nav, admin actions, overflow fixes, and expanded visual tests
2.2.1 Frontend and UX overhaul for responsive workspace, themes, graph UX, admin reflow, and file attachment
2.2.0 Multimodal-first Knowledge Graph and local model source disclosure
2.1.0 Multi-agent workflow maturity
2.0.0 AI pipeline, workflow, and plugin platform foundation
1.7.0 Graph and collaboration
1.6.0 Product experience deepening

License

MIT

Project details


Release history Release notifications | RSS feed

This version

3.5.0

Download files

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

Source Distribution

ltcai-3.5.0.tar.gz (791.4 kB view details)

Uploaded Source

Built Distribution

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

ltcai-3.5.0-py3-none-any.whl (852.0 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for ltcai-3.5.0.tar.gz
Algorithm Hash digest
SHA256 f304a9ca6e165cea9684687190e0b14ea18d784beea87b1f08b622a8381e29b1
MD5 52a01ab41649caf237b114fc56e0fc81
BLAKE2b-256 0fba80f7aaa7ac895b97fcc3224f01ce65a8e8a7223e2554c65ec325599d7364

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for ltcai-3.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1bc9f291ab30dae05c97780a56d40481b9f625ccf7514963f58fac662a1a340b
MD5 f356fda2fa12da8ce8eeedcb68f24bac
BLAKE2b-256 86f99c7f436c04250a95c5878b7ada884848ab6cec0ef8ca84786a5e27ce02b9

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