Project Structure

Your project needs three things to deploy to Reminix:

Manifest — pyproject.toml or requirements.txt
SDK — Reminix with an extra installed
Entrypoint — A file that calls serve()

Required Dependencies

Install the SDK with an extra (all extras include the runtime):

pip install reminix[openai]      # OpenAI adapter + runtime
pip install reminix[anthropic]   # Anthropic adapter + runtime
pip install reminix[langchain]   # LangChain adapter + runtime
pip install reminix[langgraph]   # LangGraph adapter + runtime
pip install reminix[llamaindex]  # LlamaIndex adapter + runtime
pip install reminix[runtime]     # Runtime only

Your manifest must include reminix with an extra:

requirements.txt

reminix[openai]>=0.7.0
openai>=1.0.0

pyproject.toml (Poetry)

[tool.poetry.dependencies]
python = "^3.12"
reminix = {extras = ["openai"], version = "^0.7.0"}
openai = "^1.0.0"

pyproject.toml (PEP 621)

[project]
dependencies = [
    "reminix[openai]>=0.7.0",
    "openai>=1.0.0",
]

Entry Point Detection

Reminix looks for your entry point in this order. The first match wins.

Priority	Entry Point	Command
1	`pyproject.toml` → `[project.scripts].start`	Custom
2	`server.py`	`python server.py`
3	`agent.py`	`python agent.py`
4	`main.py`	`python main.py`

Using a start script

If you have a pyproject.toml with a start script, Reminix will use it:

[project.scripts]
start = "myapp.server:main"

Minimal Project Example

my-agent/
├── requirements.txt
└── agent.py

requirements.txt

reminix[openai]>=0.7.0
openai>=1.0.0

agent.py

from openai import AsyncOpenAI
from reminix.adapters.openai import from_openai
from reminix.runtime import serve

client = AsyncOpenAI()
agent = from_openai(client, model="gpt-4o")

serve(agent)

Port Requirements

Your agent must listen on port 8080. The serve() function uses this by default.

serve(agent, port=8080)

Validation Errors

If your project doesn't meet the requirements, you'll see one of these errors:

Error	Cause	Fix
"No pyproject.toml or requirements.txt found"	Missing manifest	Add a `requirements.txt` or `pyproject.toml`
"Missing reminix with extras"	SDK installed without extras	Run `pip install reminix[openai]`
"No entrypoint found"	No valid entry file	Create `server.py`, `agent.py`, or `main.py`

Multi-Agent Projects

For projects with multiple agents, use server.py as the entry point:

my-project/
├── requirements.txt
├── server.py
└── agents/
    ├── __init__.py
    ├── greeter.py
    └── calculator.py

server.py

from reminix.runtime import serve
from agents.greeter import greeter
from agents.calculator import calculator

serve([greeter, calculator])

Next Steps

GitHub Integration — Deploy from GitHub
Runtime Quickstart — Build your first agent
Adapters — Use framework adapters

On this page