Noema documentation.
Guides for installing Noema, running local models, using tools, connecting devices, and understanding network behavior.
Start here
Set up your first local model.
Browse
Browse the guides.
Getting Started
Noema ConstellationYour chats follow you, and your Mac’s models become available across your personal devices.About NoemaWhat local-first means, what can stay offline, and when Noema uses a network connection.Quick StartInstall Noema, choose a starter model, and send your first fully local message.InstallationCurrent system requirements, App Store installation, and first-model setup.Set Up Noema with a BlueprintReview a proposed model, runtime, and privacy setup on the actual device before applying it.Mac Projects and AgentKeep project context together and choose exactly how Noema may inspect or change a workspace.
Models
Constellation BoostLet your iPhone help a local model on your Mac process long prompts or hold more context.Running Models LocallyHow GGUF, MLX, ExecuTorch, Core ML, and Apple Foundation Models differ in Noema 3.5.Downloading ModelsFormats, fit guidance, dependencies, licenses, and the path from Explore to Stored.Recover Downloads and Voice InstallationsWhat each installation status means, and how to resume, retry, or repair a model or voice.Model SettingsA practical guide to presets, context, sampling, helper models, and format-dependent controls.Control Reasoning HistoryDecide, per model, whether earlier reasoning stays in context for follow-up turns.Using Noema OverfitRun compatible Qwen, Gemma, Laguna, and DeepSeek mixture-of-experts models using a resident core and locally paged expert weights, then measure whether the model is practical on your device.Constellation Models, Tools & PhotosThe model runs on the Mac while the requesting device keeps control of tools, local knowledge, permissions, and the chat.Remote EndpointsProvider disclosure, endpoint security, supported routes, credentials, and Off-grid behavior.
Chat & Knowledge
Chat InterfaceCurrent conversation controls, message actions, and route visibility, including Constellation sessions.Send, Retry, and Delete Messages on MacPreparation and reply indicators, Retry Message, and Delete Message on Mac.Datasets & RAGSupported imports, embeddings, Hugging Face datasets, retrieval settings, and Dataset Health.Understand Dataset Indexing and Time EstimatesHow embedding works, why the time estimate can start as …, and what to check when indexing stalls.Search Datasets Shared by Your MacRetrieve passages from datasets your Mac shares; the original files and indexes stay on the Mac.Knowledge PacksCurated, license-cleared offline collections for local retrieval.Voice & MediaSpeech recognition, spoken responses, Voice Mode, and media transcription.
Tools & Automation
Python Code ExecutionRun Python locally inside Noema for calculations, data analysis, machine learning, symbolic mathematics, graph analysis, and scientific visualization.Private Translation in NoemaDownload a translation model once, then translate among 38 languages without sending the text to a remote AI service.Chat Tools & Tool StoreThe full callable tool catalog, permissions, confirmations, and per-chat controls.Use Mac Tools, Memory, and BenchmarksThe toolbar memory readout, Tools navigation, and Benchmarking Center results explained.Noema AutopilotPer-message routing, Phone a Friend, escalation policy, privacy, fallbacks, and receipts.Web SearchSearch controls, source reading, custom SearXNG behavior, and privacy boundaries.
Privacy & Support
Constellation Connections & PrivacyNoema tests the available paths when you press Use and selects the best working route before the first message.Constellation Model Ejection & HelpCheck both devices, confirm the Mac is awake, inspect the selected route, and use the ejection controls to manage Mac memory.Privacy & Network ActivityA feature-by-feature map of local, LAN, iCloud, Apple, Noema-operated, and third-party data paths.Privacy FAQClear answers without absolute claims or fixed performance promises.SupportWhat to include in a report and where to find logs, diagnostics, and contact controls.