Using the Athos AI Assistant

Athos is the AI assistant built into VRGS. It is a chat panel you can ask questions in plain English: how to use a feature, what a geological concept means, what is in your project database, or what is currently on screen. Athos understands the context of your project and can search your documents, run database queries, and control the 3D view on your behalf.

Athos is cloud-based — it sends your questions to a hosted language model — so it needs an internet connection. See AI & Machine Learning Requirements for connectivity and account details.

Opening Athos

Athos lives in a dockable panel. To show or hide it:

• On the Home ribbon tab, in the Windows group, click Athos.

The panel opens on the side of the VRGS window. Drag its title bar to dock it elsewhere or float it, like any other VRGS panel. Type your question in the box at the bottom and press Enter to send it. Athos streams its reply into the conversation as it is generated.

What you can ask Athos

Athos automatically decides which of its abilities to use based on your question. You do not need to tell it which tool to run.

How-to and help questions

Ask how to do something in VRGS and Athos answers from the built-in user documentation (the same content as this site). This help library ships with VRGS, so these questions work out of the box.

"How do I import an LAS well log?" "Where is the flight path timeline?" "What does the M3C2 comparison tool do?"

Geoscience and literature questions

Athos can answer scientific and geological questions from a literature library of your own papers and reports. This searches a document database attached to your project (see Setting up the literature library below). When no library is attached, Athos still answers from the language model's general knowledge, but it cannot cite your specific papers.

"What controls the geometry of hybrid event beds?" "Summarise the methods used to measure palaeocurrent directions in outcrop."

Questions about your project data

Athos can query your project database and answer in plain language, turning your question into a database query for you. Ask about the objects, measurements, and geometry in the open project.

"How many interpretation objects contain the word sandstone?" "List the dip and azimuth measurements grouped by object."

Driving and describing the 3D view

Athos can move the camera, describe what is currently displayed, and take a screenshot of the 3D view and look at it — so you can ask about what is on screen rather than describing it.

"What objects are visible right now?" "Centre the view on the model." "What am I looking at?" "Is the highlighted surface in front of or behind the fault?"

You never ask for the screenshot yourself. Athos decides a question needs a look at the scene and captures it as part of answering, so the picture always reflects the view at the moment it replies — including any camera move it made first.

Along with the image, Athos receives the capture size, how many objects are displayed, how many are selected or highlighted, and the names of the selected ones. That is why it can answer "what is the highlighted one called?" precisely: the name comes from your project, not from reading the picture.

Not every provider can see

The hosted OpenAI and Anthropic Claude providers both receive the screenshot. A local Ollama model does not — Athos still answers there, but from the scene description alone: it knows how many objects are shown and what they are called, and nothing about how they look. Switch with /switch openai or /switch claude before asking questions that depend on appearance.

A few things worth knowing about the screenshot:

• It is a rendering, not a photograph. Athos sees your scene with its current lighting, colour maps, shading, and any draped imagery. Colour in a 3D view usually comes from an attribute map rather than from rock, so treat geological readings of a viewport screenshot with caution — for real outcrop appearance, work from photographs.
• The capture is bounded by your 3D window. A larger or maximised 3D view gives Athos more detail. If a feature is off-screen, occluded, or tiny, Athos sees it that way too — navigate to a clear view before asking.
• Each question captures afresh. A follow-up such as "and what about the left-hand side of that image?" will not refer back to the previous picture, so repeat the relevant part of the question.
• A 3D view must be active. If the active window is a photograph, map, chart, or log, there is no 3D scene to capture and Athos will say so. Click into a 3D window and ask again.

Working with photogrammetry (SfM) models

If you build 3D models from photographs with Structure-from-Motion, Athos can help you understand and tune a reconstruction. The quickest way in is to right-click an SfM workflow in the project tree and choose Ask Athos about this Model — this opens the Athos panel and asks it to diagnose that specific reconstruction. You can also just ask in the chat.

"Why does my dense cloud have holes?" "How good is this reconstruction, and which photos failed to register?" "What settings did this use — should I change any?"

Athos reads the reconstruction's settings, its registration and reprojection-error figures, how it is georeferenced, its ground-control and scale-bar accuracy, the worst photos, and the per-view dense-MVS diagnostics — so its answers cite your actual numbers rather than guessing. It also knows the memory cost of the heavier settings, so it steers you away from changes that would run feature extraction out of memory.

Athos can also act on a reconstruction, always with a confirmation step first:

• Change a setting — it shows the exact before → after (for example "depth tolerance 0.025 → 0.040") and only applies it once you agree. The change takes effect on the next reconstruction.
• Run a reconstruction — it will (re)run a workflow when you explicitly ask and confirm. Reconstruction is a long job, so it runs in the background: watch the progress bar, and ask Athos to check the results when it finishes.

Acting on a model needs a hosted provider

Asking about a model and the Ask Athos about this Model menu work with any provider. Changing settings and starting a reconstruction use the tool-calling that the hosted OpenAI and Claude providers support; a local Ollama model can inspect and advise but not act. Switch with /switch claude if needed.

Sources and references

When Athos answers from your literature library or the help documentation, it lists the material it drew on under a References heading at the end of the reply. Literature sources are shown with their authors, year, title, and DOI where available; help pages are shown with their title, section, and a link. This lets you trace an answer back to its origin and read further.

Choosing the language model

By default Athos uses a hosted OpenAI model. You can switch the provider at any time from the chat box:

Command	Provider	Can see the 3D view?
/switch openai	Hosted OpenAI model (default)	Yes
/switch claude	Anthropic Claude	Yes
/switch ollama	A local Ollama server on your own hardware — see setup	No — scene description only

Use /provider to list the available providers. Running models locally with Ollama keeps your prompts on your own hardware and works offline, but the quality and speed then depend on the model and machine you run; see Running Athos Locally with Ollama to set it up, and AI & Machine Learning Requirements for how it differs from the GPU-based AI tools.

Every provider can answer help, literature, and project-database questions. The difference is seeing the 3D view, which the two hosted providers can do and a local Ollama model cannot.

Slash commands

Type / in the chat box to see command suggestions. The most useful commands are:

Command	Alias	Action
/help	/h	Show the full command reference
/clear	/c	Clear the chat history
/reset		Reset the conversation context (start a fresh topic)
/stop	/s	Cancel the request Athos is currently working on
/export	/e	Export the chat transcript to a file
/switch		Switch the language model provider, e.g. /switch claude
/provider		List the available providers
/schema		Describe the project database schema
/tables		List the tables in the project database
/sql on | /sql off		Show or hide the database queries Athos runs
/status		Show a system status summary
/version		Show the Athos version

Setting up the literature library

The scientific-literature search (the ability to answer geoscience questions from your papers) works over a small search database stored inside your project, in a folder named RAG_DB:

<project> Data\RAG_DB\rag.db
<project> Data\RAG_DB\rag.faiss

These two files are built ahead of time from a folder of PDF papers and reports using the separate RAG DB Creator tool, then copied into the project's RAG_DB folder. Once they are present, restart VRGS (or reopen the project) and Athos will search them when you ask a geoscience question, citing the matching papers in its References.

note

If the RAG_DB folder is empty, geoscience questions are still answered from the language model's general knowledge, and how-to questions keep working because the help documentation is bundled with VRGS. Only the ability to cite your literature depends on the library being present.

Getting good answers

• Ask one focused question at a time. Follow-up questions keep the context of the conversation, so you can refine an answer rather than re-asking from scratch.
• For data questions, name objects and attributes the way they appear in your project so Athos can match them.
• For questions about the 3D view, frame the shot first — Athos sees exactly what is on screen.
• Use /reset when you switch to an unrelated topic — it clears the running context so earlier questions do not colour the new answer.
• If a reply is heading the wrong way, press /stop and rephrase.

Related

• AI & Machine Learning Requirements — connectivity, accounts, and how Athos differs from the GPU-based AI tools.
• Display Options — control what is shown in the 3D view that Athos can describe.