teoria-engine

Launch and manage a local LLM inference stack with an OpenAI-compatible API.

1|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/jgabriellima/teoria-engine --skill teoria-engine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: teoria-engine
Source: https://github.com/jgabriellima/teoria-engine/tree/main/teoria-engine
Command: npx skills add https://github.com/jgabriellima/teoria-engine --skill teoria-engine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Starts, uses, and stops a production-grade self-hosted LLM inference stack, providing a private OpenAI-compatible API endpoint for local AI workloads.

Core Features & Use Cases

  • Self-hosted OpenAI-compatible API gateway and stack with Linux + NVIDIA GPU backends (vLLM) or macOS MLX.
  • Start, stop, and switch model profiles to adapt to different workloads (text, vision-language, lightweight).
  • Observability and secure local serving to other agents and tools without exposing external endpoints.

Quick Start

Install teoria-engine with the one-line installer, then run teoria-engine up to start the stack.

Frequently Asked Questions about teoria-engine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a private OpenAI-compatible API locally for my agents?

teoria-engine launches and manages a production-grade self-hosted LLM inference stack locally, exposing an OpenAI-compatible API. It applies to Linux with NVIDIA GPUs and macOS Apple Silicon, enabling local serving of LLMs to other agents and tools.

Does local LLM inference with vLLM work on macOS Apple Silicon?

teoria-engine supports Linux with NVIDIA GPUs using vLLM and macOS Apple Silicon using MLX. It enables local serving of LLMs to other agents and tools with model switching and observability.

How do I start and stop a self-hosted LLM inference stack?

teoria-engine provides runtime scripts for install, start, and stop orchestration. Install teoria-engine with the one-line installer, then run teoria-engine up to start the stack.

Can I switch between different LLM models for local serving?

teoria-engine allows you to start, stop, and switch model profiles to adapt to different workloads (text, vision-language, lightweight). It enables local serving of LLMs to other agents and tools.

Do I need Docker to orchestrate a local OpenAI-compatible gateway?

teoria-engine uses Docker for orchestration and provides runtime scripts for install, start, and stop orchestration. It launches and manages a production-grade self-hosted LLM inference stack locally, exposing an OpenAI-compatible API.