Skip to main content

​
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:
  1. Go to https://moorcheh.ai and create an account.
  2. Open https://console.moorcheh.ai.
  3. Go to API Keys and create a new key.
  4. 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: 
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:

​
Next Steps