# Percolate - AI in the data tier

<figure><img src="/files/hHKDVeNCPyK8yG6EMrLr" alt=""><figcaption></figcaption></figure>

**Percolate** brings language models, tools and agents into the database. You can orchestrate powerful agentic systems with multi-modal RAG in any language, including natural language.

***

## Try it now

To run it locally, clone the [repo](https://github.com/Percolation-Labs/percolate)&#x20;

```bash
git clone https://github.com/Percolation-Labs/percolate.git
```

From the repo, launch the docker container so you can connect with your preferred database client. This assumes you have installed Docker e.g. [Docker Desktop](https://www.docker.com/get-started/).

```bash
docker compose up -d #The connection details are in the docker-compose file
```

The easiest way to get started is to run the `init` - this will add some test data and also sync API tokens for using language models from your environment into your local database instance. This requires [Poetry](https://python-poetry.org/docs/) to be installed.

```bash
#cd clients/python/percolate to use poetry to run the cli
poetry run p8 init
```

You can ask a question to make sure things are working. Using your preferred Postgres client log in to the database on port `5438` using `password:password` and ask a question.

```sql
Select * from percolate('How does Percolate make it easy to add AI to applications?')
```

## Learn more

We are building out examples in the docs but you might start with [Percolating Python-first](/percolation-labs/recipes/percolating-python-first.md)

## Connect and Learn

To learn more follow us sing the links below

* [Github](https://github.com/Percolation-Labs/percolate)
* [Medium](https://medium.com/percolation-labs)
* [Substack](https://percolationlabs.substack.com/)
* [Bluesky](https://bsky.app/)
* [Youtube](https://www.youtube.com/@PercolationLabs)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://percolation-labs.gitbook.io/percolation-labs/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.