Skip to main content
Issues you might encounter when using Indent, and solutions to help you get back on track quickly.

​
Installation Issues

​
Installation Methods

The recommended installation method is the one-line installer:
  • Mac & Linux
  • Windows
curl -LsSf https://app.indent.com/ | sh
If you’re having trouble with the one-line installer or prefer using a different installation method, you can try one of these alternatives. They require a working Python installation on your system.
If you use uv as your Python package manager:
uv pip install indent
If you already have Python 3.10+ and pipx installed:
pipx install indent
This installs Indent in an isolated environment to avoid conflicts with other Python packages.
If you already have Python 3.10+ and prefer using pip:
pip install indent

​
Python Version Issues

Indent requires Python 3.10 or higher. If you encounter errors about incompatible Python versions:
  1. Check your Python version: 
    python --version
  2. Install a compatible Python version: 
    brew install python@3.12

    # For Debian/Ubuntu
sudo apt update
sudo apt install python3.12

# For Fedora
sudo dnf install python3.12
    Download and install Python 3.12 from python.org
  3. Use a Python version manager like pyenv if you need to maintain multiple Python versions.

​
Dependency Conflicts

If you’re experiencing Python dependency conflicts with Indent:
  1. Use pipx: Install Indent with pipx to keep it in an isolated environment: 
    pip install pipx
pipx install indent
  2. Create a virtual environment: If you prefer virtual environments: 
    python -m venv indent-env
source indent-env/bin/activate  # On Windows: indent-env\Scripts\activate
pip install indent
  3. Clean up cached packages: If you’re still having issues: 
    pip cache purge
pip install --upgrade --force-reinstall indent

​
Connection Issues

​
Indent shows “Disconnected” status

If you see a “Disconnected” status in the web interface, try these steps:
  1. Check your terminal session: Verify that the terminal where you ran indent run is still active. If it was closed or the process was terminated, the connection is lost.
  2. Reconnect to your chat: You can reconnect to an existing chat using: 
    indent run --chat-id <your-chat-id>
    Find your chat ID from:
    • The reconnect message above the text input box in the Indent web interface
    • The URL of your chat session: https://app.indent.com/chats/<your-chat-id>
    • The terminal output when you first ran indent runin the the reconnect
  3. Restart the CLI: If reconnecting doesn’t work, try restarting the Indent CLI with a fresh session: 
    indent run
  4. Check your internet connection: Ensure you have a stable internet connection, as Indent requires connectivity to function.

​
SSL/TLS Certificate Issues

If you encounter SSL certificate errors:
  1. Update your system’s certificate store: Your system might have outdated certificates.
    Ensure you’re using the latest version of macOS or run:
    sudo /usr/bin/python -m pip install --upgrade certifi
    Update your system’s CA certificates:
    sudo update-ca-certificates # Debian/Ubuntu
sudo update-ca-trust # Fedora/RHEL
    Update Windows to get the latest root certificates.
  2. Proxy interference: If you’re behind a corporate proxy or firewall, it might be intercepting SSL connections. Talk to your IT department about allowing connections to app.indent.com.

​
Authentication Issues

​
API Key Problems

If you’re having trouble authenticating with your API key:
  1. Get a fresh API key: Visit app.indent.com/settings to view or reset your API key.
  2. Re-login with your key: 
    indent login --key <your-api-key>
  3. Check your network: Ensure your network allows connections to the Indent API servers.

​
Getting More Help

If you’re still encountering issues not covered in this guide:

Contact Support

Email our team with details about your issue