RUNLOCALAIv38
->Will it run?Best GPUCompareTroubleshootStartLearnPulseModelsHardwareToolsBench
Run check
RUNLOCALAI

Independently operated catalog for local-AI hardware and software. Hand-written verdicts. Source-cited claims. Reproducible commands when we have them.

OP·Eruo Fredoline
DIR
  • Models
  • Hardware
  • Tools
  • Benchmarks
TOOLS
  • Will it run?
  • Compare hardware
  • Cost vs cloud
  • Choose my GPU
  • Prompting kits
  • Quick answers
REF
  • All buyer guides
  • Learn local AI
  • Methodology
  • Glossary
  • Errors KB
  • Trust
EDITOR
  • About
  • Author
  • How we make money
  • Editorial policy
  • Contact
LEGAL
  • Privacy
  • Terms
  • Sitemap
MAIL · MONTHLY DIGEST
Get monthly local AI changes
Monthly recap. No spam.
DISCLOSURE

Some links on this site are affiliate links (Amazon Associates and other first-class retailers). When you buy through them, we earn a small commission at no extra cost to you. Affiliate links do not influence our verdicts — there are cards we rate highly that we don't have affiliate relationships with, and cards that sell well that we refuse to recommend. Read more →

© 2026 runlocalai.coIndependently operated
RUNLOCALAI · v38
  1. >
  2. Home
  3. /Learn
  4. /How-to
  5. /How to install and set up Manus AI on your local development machine
HOW-TO · DEV

How to install and set up Manus AI on your local development machine

intermediate·20 min·By Eruo Fredoline
Target environment
Ubuntu 24.04 · Manus Desktop 1.xmacOS 14.x · Manus Desktop 1.x
PREREQUISITES

Python 3.10+ installed, git installed, OpenAI-compatible API key for model access

What this does

This guide covers installing the Manus AI desktop application and configuring the local CLI backend that enables autonomous task execution, file manipulation, and workflow automation directly from the terminal. The setup process includes environment configuration, API key provisioning, and basic connectivity verification.

Steps

  1. Download the Manus Desktop application for the target operating system from the official website at manus.im and run the installer. Follow the on-screen instructions to complete the GUI installation.
  2. Open a terminal and verify Python is present by running python3 --version. Confirm the output shows 3.10 or higher.
  3. Install the Manus CLI backend package using pip install manus-ai if a pip-installable package is available, or clone the repository with git clone https://github.com/manusa/manus-ai.git and run the setup script.
  4. Create a credentials file at ~/.manus/credentials.json with the following structure, replacing the placeholder with a valid API key:
    {
  "api_key": "sk-your-key-here",
  "base_url": "https://api.openai.com/v1"
}
  5. Set the MANUS_API_KEY environment variable as a fallback by adding export MANUS_API_KEY="sk-your-key-here" to the shell profile file such as ~/.bashrc or ~/.zshrc.
  6. Verify the CLI installation by running manus --version. A version string should appear without errors.
  7. Test connectivity by running manus check-config. This command attempts to reach the API endpoint and confirms whether authentication succeeds.
  8. Start a Manus session with manus session start and follow the prompts to grant filesystem permissions for the first run.

Verification

manus check-config

Expected output:

Manus AI Configuration Check
API connectivity: OK
Authentication: OK
Local backend: running on port 8080
Configured model: gpt-4o

Common failures

  1. Python version below 3.10 — The CLI may fail to start or exhibit missing module errors. Use python3 --version to confirm the version, and install a newer Python via python.org or a system package manager if needed.

  2. API key rejected by the provider — An invalid or expired key produces an authentication error during manus check-config. Verify the key is active in the provider dashboard and that the base_url matches the correct endpoint for the key type.

  3. Port 8080 already in use — The Manus local backend attempts to bind to port 8080 by default. If another process occupies this port, the startup fails. Identify the conflicting process with lsof -i :8080 and stop it, or configure Manus to use an alternative port in ~/.manus/config.json.

  4. Missing write permissions for ~/.manus directory — The credentials file must be created in a directory that the user can write to. Create the directory manually with mkdir -p ~/.manus and set appropriate permissions before running the setup commands.

Related guides

  • Create a task completion workflow in Manus AI for building a React component
  • Use Manus AI to research and compare API options for your project
← All how-to guidesCourses →