Skip to main content
Fli can be installed in multiple ways depending on your use case. Choose the method that best fits your needs.

​
Requirements

  • Python 3.10 or higher
  • pip, pipx, or uv package manager
Fli requires Python 3.10+ and works on Linux, macOS, and Windows.

​
Installation methods

​
Verify installation

After installation, verify that Fli is installed correctly: 
# Check Fli version
fli --help

# You should see the help message with available commands

​
Available commands

After installation, the following commands are available:
CommandDescription
fliMain CLI interface for flight searches
fli-mcpMCP server for STDIO communication
fli-mcp-httpMCP server over HTTP at http://127.0.0.1:8000/mcp/

​
Development installation

If you want to contribute to Fli or run it from source:
1

Clone the repository

git clone https://github.com/punitarani/fli.git
cd fli
2

Install with development dependencies

# Using uv (recommended)
uv sync --all-extras

# Or using pip
pip install -e ".[dev]"
3

Verify development setup

# Run tests
uv run pytest

# Run linting
uv run ruff check .

# Run CLI from source
uv run fli --help

​
Troubleshooting

If you installed with pipx, make sure pipx’s bin directory is in your PATH:
python3 -m pipx ensurepath
Then restart your terminal or run:
source ~/.bashrc  # or ~/.zshrc on macOS
Fli requires Python 3.10 or higher. Check your Python version:
python3 --version
If you need to install a newer Python version, use:
If you encounter permission errors during installation:
# Use --user flag with pip
pip install --user flights

# Or use pipx (recommended)
pipx install flights
If you can’t import Fli modules, ensure you’re in the correct environment:
# Check if Fli is installed
pip list | grep flights

# Reinstall if necessary
pip install --force-reinstall flights

​
Next steps

Quick start

Get started with your first flight search

MCP Server setup

Configure the MCP server for Claude Desktop

Build docs developers (and LLMs) love

Get started for freeTalk to us