Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.memanto.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Installation & Setup

Memanto requires a Moorcheh API key. This page focuses on setup only. For exact CLI command output and full command behavior, use the CLI reference as ground truth:

​
Prerequisites

  • Python 3.10+ (for CLI and local server)
  • Docker (optional, for containerized deployment)
  • Moorcheh API key (free tier available)

​
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

pip install memanto
Or with uv: 
pip install uv
uv tool install memanto

​
Option B: Install from source

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

​
Option C: Docker Installation

Build a containerized Memanto server: 
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