Installation & Setup

Memanto requires a Moorcheh API key or run it On-Prem for free. This page focuses on setup only. For exact CLI command output and full command behavior, use the CLI Overview.

Prerequisites

Python 3.10+ (for CLI and local server)
Node.js 18+ (for TypeScript SDK)
Docker (optional, for containerized deployment)
Moorcheh API key (free tier available)

Want to run everything on your own hardware without a Moorcheh API key? See the On-Prem Quickstart — same CLI, local Moorcheh server in Docker, optional fully-local Ollama for embeddings and LLM answers.

Step 1: Get a Moorcheh API Key

Quick path:

Go to https://moorcheh.ai and create an account.
Open https://console.moorcheh.ai.
Go to API Keys and create a new key.
Copy the key immediately (it is only shown once).

This is enough to continue installation. For advanced topics (security practices, free tier planning, multi-environment setup, and sovereign deployment), see Moorcheh Setup & Integration.

Step 2: Install Memanto

Choose your preferred method:

Option A: CLI install (recommended)

pip install memanto

Or with uv:

pip install uv
uv tool install memanto

Option B: TypeScript / Node.js SDK

For Node.js and TypeScript projects, use the official SDK:

npm install @moorcheh-ai/memanto

Prerequisites: Node.js 18+ and uvx on PATH (install uv). The SDK boots a local Memanto server on demand and exposes an ergonomic Memanto client. See the TypeScript SDK Reference for full documentation.

Option C: Install from source

For development and customization:

git clone https://github.com/moorcheh-ai/memanto.git
cd memanto
pip install uv
uv sync

Option D: Docker

Pull the pre-built image (recommended):

docker pull moorcheh/memanto:latest
docker run -p 8000:8000 -e MOORCHEH_API_KEY=your_api_key moorcheh/memanto:latest

The server is now available at http://localhost:8000. Or build from source:

git clone https://github.com/moorcheh-ai/memanto.git
cd memanto
docker build -t memanto .
docker run -p 8000:8000 -e MOORCHEH_API_KEY=your_api_key memanto

Step 3: Configure API Key

Recommended interactive setup:

# Launch interactive configuration
memanto

Follow the prompts:

Enter your Moorcheh API key: your_api_key_here
[Optional] Configure daily summary schedule? (y/n): y
What time should daily summaries run? (HH:MM in 24-hour format, UTC): 09:00

Configuration is stored in ~/.memanto/config.json (secure, not in git).

Manual Configuration

If you prefer to skip the interactive setup:

# Set environment variable
export MOORCHEH_API_KEY=your_api_key

# Or create .env file in project directory
echo "MOORCHEH_API_KEY=your_api_key" > .env

Confirm Configuration Is Saved

memanto config show

Expected indicators:

Moorcheh API Key:    ✓ Configured
Configuration Path:  ~/.memanto/config.json

Step 4: Verify Setup

# Confirm CLI is installed
memanto --version
# Confirm key + connectivity + config
memanto status

Optional API/server verification:

# Start local Memanto API server
memanto serve

In another terminal:

# Verify health endpoint
curl http://localhost:8000/health

Troubleshooting

Missing API key: run memanto again, then check memanto config show.
Connection issues: verify key in memanto config show and check network access.
Port in use: run memanto serve --port 8001.
Unauthorized errors from API calls: ensure you are sending the correct X-Session-Token header.

For full troubleshooting and expected command outputs, see:

CLI Overview

Getting Started

Guides

Reference

Installation & Setup

Installation & Setup

Prerequisites

Step 1: Get a Moorcheh API Key

Step 2: Install Memanto

Option A: CLI install (recommended)

Option B: TypeScript / Node.js SDK

Option C: Install from source

Option D: Docker

Step 3: Configure API Key

Manual Configuration

Confirm Configuration Is Saved

Step 4: Verify Setup

Troubleshooting

Next Steps

​Installation & Setup

​Prerequisites

​Step 1: Get a Moorcheh API Key

​Step 2: Install Memanto

​Option A: CLI install (recommended)

​Option B: TypeScript / Node.js SDK

​Option C: Install from source

​Option D: Docker

​Step 3: Configure API Key

​Manual Configuration

​Confirm Configuration Is Saved

​Step 4: Verify Setup

​Troubleshooting

​Next Steps

Installation & Setup

Prerequisites

Step 1: Get a Moorcheh API Key

Step 2: Install Memanto

Option A: CLI install (recommended)

Option B: TypeScript / Node.js SDK

Option C: Install from source

Option D: Docker

Step 3: Configure API Key

Manual Configuration

Confirm Configuration Is Saved

Step 4: Verify Setup

Troubleshooting

Next Steps