Get started
Let’s get Ontomato
ready for you.
Follow the guided setup preview, or use the published Docker instructions. Choose the route that feels right for you.
A little guidance, all the way.
Explore the steps we’re preparing. The guided installer is not available yet.
Install Ontomato
Choose your computer. The planned launcher will help you check requirements and start Ontomato.
Ontomato for macOSInstaller being prepared
What you should seeOntomato is installed and ready to open.
Open your workspace
Once the service is running, open your workspace in the browser.
Welcome to your workspace.Let’s connect the models that will work with your ontology.
What you should seeA workspace with a clear next step.
Connect your model
Add a chat model and an embedding model. The guide will explain each setting in plain language.
Understands questions and writes answers
Not connectedHelps find relevant text
Not connectedWhat you should seeBoth model connections have been checked.
Load an example
Start with a prepared world so you can learn without connecting your own business data.
Films · People · Roles
Characters · Places · Encounters
Live example datasets are still being connected.
What you should seeAn example ontology with its connected data.
Ask your first question
Ask about the example, then follow its relationships to see where the answer comes from.
Which people connect these movies?
Your answer and its source records will appear together.
What you should seeAn answer with the records behind it.
Illustrative screens. This preview does not install software, check your computer or connect data.
Run the open-source product.
Use the repository’s Docker Compose setup. Configure your environment before running the start command.
Git, Docker Engine 26+ with Compose, OpenAI-compatible chat and embedding endpoints, and a PostgreSQL business database.
Minimum: 4 CPU cores, 8 GB RAM and 20 GB free disk.
Get the files
git clone https://github.com/Aohan/Ontomato.git
cd Ontomato/deploy
cp .env.example .envgit clone https://github.com/Aohan/Ontomato.git
cd Ontomato/deploy
Copy-Item .env.example .envEdit .env before starting
- ARCH: match your machine, amd64 or arm64.
- POSTGRES_PASSWORD: choose your own database password.
- PUBLIC_HOST: the hostname or IP you will open in your browser.
Check the embedding dimensions in the deployment guide before the first start.
Start the configured stack
One line, after configuration. Run it from Ontomato/deploy. It does not install Docker or configure models.
docker compose -f docker-compose.ghcr.yml up -dWhen all services are healthy, open your host on port 3000. Configure chat and embedding models in the Admin Panel, then connect your business database.
Commands checked against the public repository on 9 October 2026. Deployment has not been run as part of this website preview.
Give your agent the Ontomato skills.
For an existing Ontomato deployment and an agent that supports skills. Requires Node.js 18+.
npx skills add Aohan/Ontomato --skill ontomato-ontomap-builder ontomato-analyst ontomato-app-builderThis one-liner adds agent skills. It does not install the Ontomato server.
ontomato-ontomap-builder- Model your data
ontomato-analyst- Ask and analyse
ontomato-app-builder- Build on a test deployment
After installing, set ONTOMATO_URL in your agent’s environment to your Workbench address. You can also set envUrl in each skill’s application.yml.
Commands checked against the public repository on 9 October 2026. Deployment has not been run as part of this website preview.
A few things to have ready.
These are the current product requirements. The guided setup is being designed to help you through them.
- A computer or server
- Docker runs the product’s services together. The published guide explains the machine requirements.
- Access to two models
- A chat endpoint for answers and an embedding endpoint for text search, with any credentials your provider needs.
- A PostgreSQL database
- Use your own business database with the product today. The website’s Movies and Journey worlds are still design previews.
Keep a guide close by.
Understand the ontology
Types, properties, relationships and source mappings.
Run the learning sample
Download a small supply-chain calculation to explore locally.
Source & license
The public repository, Apache-2.0 license and contribution guide.
Find help on GitHub
Browse existing Issues or open a question with setup details.