Skip to main content

​
Required Folder Structure

Osmosis relies on convention-over-configuration to auto-discover your components. Set up the directories below, and every git push will sync your tools, reward functions, and rubrics to the platform. An example repository can be found here: https://github.com/Osmosis-AI/osmosis-git-sync-example

​
Directory Breakdown

​
mcp/ - MCP Tools Directory

Contains your Model Context Protocol tools that extend AI agent capabilities. Key files:
  • main.py - Entry point for the FastMCP server
  • server/mcp_server.py - FastMCP server configuration
  • tools/ - Directory containing individual tool modules

​
reward_fn/ - Reward Functions Directory

Contains deterministic reward functions decorated with @osmosis_reward. Example:
  • compute_reward.py - Your reward function implementations

​
reward_rubric/ - Reward Rubrics Directory

Contains LLM-based evaluation functions decorated with @osmosis_rubric. Example:
  • reward_rubric_openai.py - Rubric using OpenAI models
  • reward_rubric_anthropic.py - Rubric using Anthropic models

​
pyproject.toml - Dependencies

Defines your Python package dependencies: 
[project]
name = "my-osmosis-repo"
version = "0.1.0"
requires-python = ">=3.10"
dependencies = [
    "osmosis-ai>=0.2.13",
    "fastmcp>=0.1.0",
]

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

​
Optional Directories

You can also include:
  • tests/ - Unit tests for your components
  • .github/workflows/ - CI/CD automation
  • docs/ - Additional documentation

​
Next Steps

MCP Tools

Learn to create MCP tools

Reward Functions

Build reward functions

Reward Rubrics

Implement rubric scoring