Getting started

So you decided to get started with Forma! That is great! The next few sections will show you how to get started and develop your first AI Agent with memory and tools.

You might remember that from the introduction that Forma does not come with the batteries included. This means that in order to develop with Forma you will need to install and get familiar with several (although, very common) developer tools:

1. A Code or Text editor - Necessary to define the AI Agents
2. The Forma CLI - Necessary to run, test, evaluate, and deploy AI Agents
3. Docker (or similar) - To run services like databases, observability platforms, etc.
4. git - For managing different versions and changes in an auditable and secure manner.
5. Other emulators - Depending on how you want to deploy your agent, you might need to emulate other cloud services.

Note - We know this adds frictions, and yet it is a deliberate choice. The reason is that, even if it makes it hard to get started, it really ensures consistency and flexibility... And also, if you are getting into this domain, learning these tools will be necessary.

You develop Forma agents in a text editor

Forma agents are fully described using text files and, therefore, it is only natural that your main development tool will be a code/text editor. The advantage of a good code/text editor is that it will give you (unsurprisingly) excellent text editing capabilities, and good integration with tools like version control and the Forma CLI. Additionally, a good editor will be able to highlight the syntax of the different file formats we will be using (yaml, markdown, json).

Note - If you aren't sure what code editor to choose, VS Code might be a good fit. If you have strong opinions about this—and many people do—use whatever suits you.

You interact with Forma agents using the Forma CLI

The Forma CLI is the main tool you will use during development. Among other things, it will help you:

• Start new projects (forma init)
• Run a development server for testing and prototyping (forma serve)
• Evaluat your agent to ensure quality and guide your prompting (forma eval)

Read more details on the how to define your first agent section.

You use Docker (or similar) to emulate services during development

Forma agents are meant to be a part of a more complex system. Containers—which can be ran using Docker, or Podman or other alternatives—help you run services locally. This means you can simulate and test how your AI Agent would interact with the rest of the system (e.g., authentication, APIs, Databases, etc.).