OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Agent Frameworks

Mentals AI

Mentals AI is a C++ command-line framework for creating and operating AI agents from .gen Markdown files. Agent definitions can combine named instructions, recursive loops, memory and tools; instructions may refer to one another, and Python can be included when needed. The repository documents OpenAI API configuration and includes example agents for tasks such as collecting YouTube video details into CSV files and pr

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Mentals AI — OpenViST project profile in Agent Frameworks.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use it when you want to author agent logic as Markdown and operate it locally through a CLI rather than write Python scaffolding for the workflow.

Who it is for

  • Developers who want to express agent instructions and control flow in Markdown files.
  • People building command-line agent workflows that use tools, memory or linked instructions.
  • Experimenters who want to assemble or connect their own reasoning approaches.

Documented uses

  • Define an agent’s instructions and their references in a .gen file.
  • Run an agent through the command-line interface.
  • Build example content workflows for collecting video information, transcribing videos or drafting topic-based articles.
Before you choose

Requirements & limits

The project is a public GitHub repository under the MIT license. Its documented setup requires an OpenAI API key.

  • The README documents OpenAI configuration and notes Llama 3 support through providers compatible with the OpenAI API.
  • Building requires the listed C++ dependencies and Make; the README provides dependency instructions for Linux, macOS and Windows.
  • The README marks the local vector database and web UI as work in progress.
  • The README says Python can be integrated into Markdown agent scripts when needed.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Build Mentals AI and run the included loop agent

Follow the README’s documented setup path to build the CLI and invoke its example agent.

Before you start

  • An OpenAI API key
  • libcurl, libfmt and poppler dependencies
  • A terminal and Make

Steps

  1. Install the listed dependencies using the README’s instructions for your operating system.

  2. Clone the repository and enter its directory.

  3. Add the API key, endpoint and model settings to config.toml.

  4. Run make, then invoke ./build/mentals agents/loop.gen -d.

Expected outcome

The documented command invokes Mentals AI with the agents/loop.gen example file.

Guide limitations

  • The README documents setup and invocation but does not specify the example’s output.
  • The README says pgvector installation can be skipped on the main branch.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
14 October 2026
Original website title
turing-machines/mentals-ai · Official homepage title · retained in its source language
How we review sourcesSuggest a correction