Issues you might encounter when using Exponent, and solutions to help you get back on track quickly.

​
Installation Issues

​
Installation Methods

The recommended installation method is the one-line installer: 
curl -LsSf https://exponent.run/install.sh | 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.

​
Python Version Issues

Exponent 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:
  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 Exponent:
  1. Use pipx: Install Exponent with pipx to keep it in an isolated environment: 
    pip install pipx
pipx install exponent-run
  2. Create a virtual environment: If you prefer virtual environments: 
    python -m venv exponent-env
source exponent-env/bin/activate  # On Windows: exponent-env\Scripts\activate
pip install exponent-run
  3. Clean up cached packages: If you’re still having issues: 
    pip cache purge
pip install --upgrade --force-reinstall exponent-run

​
Connection Issues

​
Exponent 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 exponent 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: 
    exponent run --chat-id <your-chat-id>
    Find your chat ID from:
    • The reconnect message above the text input box in the Exponent web interface
    • The URL of your chat session: https://exponent.run/chats/<your-chat-id>
    • The terminal output when you first ran exponent runin the the reconnect
  3. Restart the CLI: If reconnecting doesn’t work, try restarting the Exponent CLI with a fresh session: 
    exponent run
  4. Check your internet connection: Ensure you have a stable internet connection, as Exponent 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.
  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 exponent.run.

​
Authentication Issues

​
API Key Problems

If you’re having trouble authenticating with your API key:
  1. Get a fresh API key: Visit exponent.run/settings to view or reset your API key.
  2. Re-login with your key: 
    exponent login --key <your-api-key>
  3. Check your network: Ensure your network allows connections to the Exponent 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

Join the Community

Ask questions and get help from the community