Skip to main content

Installation

pip install arifos

With Development Tools​

pip install arifos[dev]

All Dependencies​

pip install arifos[all]

From Source​

# Clone the repository
git clone https://github.com/ariffazil/arifOS.git
cd arifOS

# Install in development mode
pip install -e .

# Or with dev tools
pip install -e ".[dev]"

Requirements​

  • Python: 3.10+
  • Dependencies: numpy, pydantic, anyio, starlette, fastmcp

Running the Server​

Stdio Mode (Local Clients)​

For Claude Desktop, Cursor, and other local MCP clients:

python -m arifos.mcp

SSE Mode (Remote Connections)​

For remote connections or self-hosting:

python -m arifos.mcp sse

Default port: 8000 (configurable via PORT environment variable)

Docker​

FROM python:3.12-slim

WORKDIR /app
COPY . .
RUN pip install -e .

EXPOSE 8000
CMD ["python", "-m", "arifos.mcp", "sse"]
docker build -t arifos .
docker run -p 8000:8000 arifos

Verify Installation​

# Check version
python -c "import arifos; print(arifos.__version__)"

# Run health check
curl http://localhost:8000/health