callama

callama is a small API experiment for sending a user query through an API endpoint to an Ollama model and returning the model response.

The goal is simple: test how a prompt travels from a client request, into an API route, through the model layer, and back to the user as a response.

What It Does

• Starts a FastAPI app.
• Returns a random default response from the root endpoint.
• Accepts a query at /model/ask.
• Sends that query to an Ollama model.
• Returns the original query, selected model name, and model response.

Project Structure

callama/
|-- main.py                 # FastAPI app entry point
|-- model.py                # Ollama model call wrapper
|-- default_respones.py     # Random default root responses
|-- router/
|   `-- askmodel.py         # /model/ask endpoint
|-- example.env             # Example environment variables
|-- pyproject.toml          # Project metadata and uv dependencies
|-- requirements.txt        # Pinned dependency list
`-- README.md

Requirements

• Python 3.13 or newer
• Ollama access configured for the model you want to use
• uv or pip

Setup

Clone the project and enter the folder:

git clone https://github.com/Pulsedude/callama.git
cd callama

Create a .env file from the example:

cp example.env .env

Edit .env and set the model:

OLLAMA_CLOUD_API_KEY=
MODEL=gpt-oss:120b-cloud

Use any Ollama model name that is available in your environment.

Install Dependencies

Using uv:

uv sync

Or using pip:

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

Run The API

uvicorn main:app --reload --port 8000

The API will run at:

http://127.0.0.1:8000

Endpoints

Root

GET /

Returns a random default response.

Example:

curl http://127.0.0.1:8000/

Ask The Model

GET /model/ask?query=<your-query>

Sends your query to the configured Ollama model.

Example:

curl "http://127.0.0.1:8000/model/ask?query=What%20is%20FastAPI?"

Example response:

{
  "query": "What is FastAPI?",
  "model": "gpt-oss:120b-cloud",
  "response": "FastAPI is a modern Python web framework..."
}

API Docs

After starting the server, open:

http://127.0.0.1:8000/docs

The OpenAPI schema is available at:

http://127.0.0.1:8000/openapi.json

Notes

• This is an experiment, not a production-ready API.
• The model name comes from the MODEL environment variable.
• Make sure your Ollama setup can access the selected model before calling /model/ask.
• Error handling is intentionally simple for now.

Free To Use

This experiment is free to use, copy, modify, and learn from.

If you use it in your own project, attribution is appreciated but not required. For clearer legal reuse, consider adding a formal open source license file such as MIT.