📚 Ollama Library API Proxy

A simple proxy API that fetches, parses, and caches data from ollama.com.

🔧 Documentation

• Swagger UI (/docs)
• ReDoc UI (/redoc)

🕒 Note: All responses are cached for 6 hours by default.

---

Setup Instructions

1. Rename the environment file
   Rename example.env to .env.

2. Configure your environment
   Open the .env file and customize the values as needed, such as:

   • API URL
   • Cache duration
   • Enable static website mode

3. Install dependencies
   Run the following command to install all required Python packages:

   pip install -r requirements.txt

4. Run the API

   ollama_library_api.py

   Or if you're getting errors:

   uvicorn ollama_library_api:app --host 0.0.0.0 --port 5115 --reload

Example .env

# CODE version of the app
CODE_VERSION=1.3.0_Release

# Base URL of Ollama
OLLAMA_COM_BASE_URL=https://ollama.com

# Your API URL
CURRENT_BASE_URL=https://example.com

# If running a static website
STATIC_WEBSITE=False

# Cache duration in hours
CACHE_EXPIRE_AFTER=6

🔍 Example Endpoints

📊 Library Namespace

• 🔥 Popular models:
  /library?o=popular
• 🆕 Newest models:
  /library?o=newest
• 👁️ Filter by vision capability:
  /library?c=vision

---

👤 User-Specific Queries

• 🔥 Popular models by jmorganca:
  /jmorganca?o=popular
• 📄 Get details for nextai by htdevs:
  /htdevs/nextai

---

🔎 Search & Model Info

• 🔍 Search for mistral:
  /search?q=mistral
• 📘 Details for llama3:
  /library/llama3
• 🏷️ Tag details for llama3:8b:
  /library/llama3:8b
• 🏷️ All tags for llama3:
  /library/llama3/tags

---

🧱 Blobs & Digests

• 📦 Get model blob for llama3:8b:
  /library/llama3:8b/blobs/model
• ⚙️ Get params blob for llama3:8b:
  /library/llama3:8b/blobs/params
• 🧬 Get blob by digest:
  /library/llama3:8b/blobs/a3de86cd1c13

---

🧑 Credits

• Programmed by Blood Shot
• Maintained by Houloude9
• Hosted by Koyeb

💡 Tip: Use these endpoints to build your own Ollama-powered dashboards, tools, or integrations effortlessly.