Skip to content

Commit 61eb534

Browse files
authored
Merge pull request #96 from mindsdb/update-readme-positioning
docs: Reposition README - Anton as a general-purpose autonomous agent
2 parents fc600c7 + e669017 commit 61eb534

1 file changed

Lines changed: 55 additions & 39 deletions

File tree

README.md

Lines changed: 55 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -6,18 +6,14 @@
66
▐ ▐ █▀█ █ ▀█ █ █▄█ █ ▀█
77
▐ ▐
88
```
9+
# Meet Anton - an autonomous agent that gets real work done
10+
Anton is your personal AI agent that works so you don't have to. Tell it what you need in plain language and it takes it from there - sending emails, calling APIs, connecting to data sources, building dashboards, and delivering results. No setup, no plugins, no fuss.
911

10-
# MindsDB Anton — What Business Intelligence is supposed to be
11-
12-
Business intelligence was supposed to give you the right data, at the right time, to get real work done.
13-
14-
That is Anton. You ask questions in plain language, and Anton takes ownership of the entire analytical process:
15-
it pulls and unifies data from multiple sources, runs the analysis, surfaces insights, builds rich dashboards, suggests next steps, and can even take action - A business intelligence agent that works like an expert analyst — 24/7, at machine speed.
12+
It doesn't just answer questions. It *does things*: cleans your inbox, builds integrations, analyzes your data, automates workflows - whatever the task requires.
1613

1714
![ezgif-24b9e7c74652f0dc](https://github.com/user-attachments/assets/c92f87c1-ff30-4272-92ba-49a8585d5954)
1815

19-
20-
## Quick start
16+
## Quick start
2117
**macOS - Desktop App:**
2218

2319
<a href="https://mindsdb-anton.s3.us-east-2.amazonaws.com/anton-latest-universal-signed.pkg">
@@ -42,17 +38,20 @@ That's it, you can now run it by simply typing the command:
4238
anton
4339
```
4440

45-
## Using Anton
41+
## What can Anton do?
42+
43+
Anton figures things out live. It doesn't rely on pre-built plugins or predefined workflows - it writes code on the fly, calls APIs, and chains together whatever steps are needed to get the job done.
4644

47-
Talk to Anton like a person, for example, ask Anton this:
45+
Here are a few examples of what people are using it for:
4846

47+
### 📊 Data analysis & dashboards
4948
```
5049
I hold 50 AAPL, 200 NVDA, and 10 AMZN. Get today's prices, calculate my
5150
total portfolio value, show me the 30-day performance of each stock, and
5251
any other information that might be useful. Give me a complete dashboard.
5352
```
5453

55-
What happens next is the interesting part. At first, Anton doesn't have any particular skill related to this question. However, it figures it out live: scrapes live prices, writes code on the fly, crunches the numbers, and builds you a full dashboard all in one conversation, with no setup.
54+
What happens next is the interesting part. At first, Anton doesn't have any particular skill related to this question. However, it figures it out live: scrapes live prices, writes code on the fly, crunches the numbers, and builds you a full dashboard - all in one conversation, with no setup.
5655

5756

5857
```text
@@ -64,13 +63,42 @@ Summary: Concentration risk is your #1 issue. If you're comfortable being a high
6463
<img width="800" alt="Anton's response" src="https://github.com/user-attachments/assets/6dc6ee81-2a2c-4358-be05-bfe884c32685" />
6564
</p>
6665

67-
**Key features**
66+
### 📬 Email cleanup
67+
```
68+
Dear Anton, please help me clear unwanted emails...
69+
```
70+
71+
Anton scans your inbox, classifies emails by signal vs. noise, identifies unsubscribable marketing, cold outreach, and internal tool notifications - then surfaces a breakdown and handles the cleanup. One user ran it on ~1,000 emails and found ~35% were un-subscribable. Anton surfaced everything AND handled the cleanup.
72+
73+
### 💬 Build its own integrations
74+
```
75+
Set up a WhatsApp integration so I can message you from my phone.
76+
```
77+
78+
Anton doesn't wait for someone to build a connector. It writes the integration code itself, sets it up, and gets it running - so you can chat with it from WhatsApp, Telegram, or whatever channel you need.
79+
80+
### 🔧 Ask for anything that takes requires action
81+
- **Send emails** - connect accounts, draft messages or even send them on your behalf.
82+
- **Manage Calendarss** - Summarize your day, create meetings, block time, etc. All just by asking.
83+
- **Automated reporting** - pull from multiple databases, crunch numbers, deliver a report on a schedule.
84+
- **Workflow automation** - monitor a source, react to changes, take action.
85+
- **Research & synthesis** - scrape the web, summarize findings, build a reference document.
86+
- **Data pipeline prototyping** - connect sources, transform data, load into a destination.
87+
- **System administration** - audit configurations, generate reports, fix issues.
88+
89+
The pattern is always the same: you describe the outcome, Anton figures out the steps.
90+
91+
---
92+
93+
## Key features
6894
- **Credential vault** - prevents secrets from being exposed to LLMs.
69-
- **Isolated code execution** - protected, reproducible “show your work” environment.
70-
- **Multi-layer memory & continuous learning** - session, semantic and long-term business knowledge.
95+
- **Isolated code execution** - protected, reproducible "show your work" environment.
96+
- **Multi-layer memory & continuous learning** - session, semantic and long-term knowledge. Anton remembers what it learned and gets better at your specific workflows over time.
97+
98+
---
7199

72100
#### Connect your data
73-
Although you can use Anton with just public data, the real power happens when you combine that with your own data. This can be anything: files, databases, application APIs,... etc. Open the Local Vault with `/connect` command, then follow the prompts to add your secrets. Anton only has access to secret names - secret values remain hidden.
101+
Although you can use Anton with just public data, the real power happens when you combine that with your own data. This can be anything: files, databases, application APIs,... etc. Open the Local Vault with `/connect` command, then follow the prompts to add your secrets. Anton only has access to secret names - secret values remain hidden.
74102

75103
```powershell
76104
/connect
@@ -110,32 +138,28 @@ ANTON>
110138

111139
---
112140

113-
### Explainable by default
114-
115-
You can always ask Anton to explain what it did. Ask it to dump its scratchpad and you get a full notebook-style breakdown: every cell of code it ran, the outputs, and errors — so you can follow its reasoning step by step.
141+
You can always ask Anton to explain what it did. Ask it to dump its scratchpad and you get a full notebook-style breakdown: every cell of code it ran, the outputs, and errors - so you can follow its reasoning step by step.
116142

117143
---
118144

119145
## What's inside
120-
121146
<p align="center"><img width="800" alt="image" src="/assets/anton-diagram.png" /></p>
122147

123148
For the full architecture of Anton, file formats, and developer guide, see **[anton/README.md](anton/README.md)**.
124149

125150
---
126151

127152
## Workspace layout
128-
129153
When you run `anton` in a directory:
130154

131-
- `.anton/` workspace folder containing scratchpad state, episodic memory, and local secrets.
132-
- `.anton/anton.md` optional project context (Anton reads this at conversation start).
133-
- `.anton/.env` workspace configuration variables file (local file).
134-
- `.anton/episodes/*` episodic memories, one file per session.
155+
- `.anton/` - workspace folder containing scratchpad state, episodic memory, and local secrets.
156+
- `.anton/anton.md` - optional project context (Anton reads this at conversation start).
157+
- `.anton/.env` - workspace configuration variables file (local file).
158+
- `.anton/episodes/*` - episodic memories, one file per session.
135159
- `.anton/memory/rules.md` - behavioral rules: Always/never/when rules (e.g., never hardcode credentials, how to build HTML)
136160
- `.anton/memory/lessons.md` - factual knowledge: Things I've learned (stock API quirks, dashboard patterns, data fetching notes)
137161
- `.anton/memory/topics/*` - topic-specific lessons: Deeper notes organized by subject (dashboard-visualization, stock-data-api, etc.)
138-
162+
139163
Override the working folder:
140164
```bash
141165
anton --folder /path/to/workspace
@@ -144,25 +168,22 @@ anton --folder /path/to/workspace
144168
---
145169

146170
## Memory systems
147-
148171
Anton provides two human-readable memory systems:
149172

150-
- **Semantic memory** rules, lessons, identity and domain expertise stored as markdown at global and project scope.
151-
- **Episodic memory** a timestamped archive of every conversation (JSONL in `.anton/episodes/`). Anton can recall prior sessions with the `recall` tool.
173+
- **Semantic memory** - rules, lessons, identity and domain expertise stored as markdown at global and project scope.
174+
- **Episodic memory** - a timestamped archive of every conversation (JSONL in `.anton/episodes/`). Anton can recall prior sessions with the `recall` tool.
152175

153176
Configure memory via `/setup` > Memory or via environment variables.
154177

155178
---
156179

157180
### Prerequisites
158-
159-
- `git` — required
181+
- `git` - required
160182
- Python **3.11+** (Anton will bootstrap an environment if missing)
161-
- `curl` macOS / Linux installs
183+
- `curl` - macOS / Linux installs
162184
- Internet connection (scratchpad may access web sources)
163185

164186
### Windows scratchpad firewall
165-
166187
The Windows installer can add a firewall rule so the scratchpad can reach the internet. If you skipped it, run in an elevated PowerShell:
167188

168189
```powershell
@@ -172,23 +193,19 @@ netsh advfirewall firewall add rule name="Anton Scratchpad" dir=out action=allow
172193
---
173194

174195
## How Anton differs from coding agents
175-
176-
Anton is a *doing* agent: code is a tool to get results. Where coding agents focus on producing code for a codebase, Anton focuses on delivering the outcome — a dataset, report, dashboard, or automated workflow — and will write whatever code is necessary to achieve that goal.
196+
Anton is a *doing* agent: code is a means, not the end. Where coding agents focus on producing code for a codebase, Anton focuses on delivering the outcome - a cleaned inbox, a live dashboard, a working integration, an automated workflow - and will write whatever code is necessary to achieve that goal.
177197

178198
---
179199

180200
## Is "Anton" a Mind?
181-
182201
Yes, at MindsDB we build AI systems that collaborate with people to accomplish tasks, inspired by the culture series books, so yes, Anton is a Mind :)
183202

184203
## Why the name "Anton"?
185-
186-
We really enjoyed the show *Silicon Valley*. Gilfoyle's AI — Son of Anton — was an autonomous system that wrote code, made its own decisions, and occasionally went rogue. We thought it was was great name for an AI that can learn on its own, so we kept Anton, dropped the "Son of".
204+
We really enjoyed the show *Silicon Valley*. Gilfoyle's AI - Son of Anton - was an autonomous system that wrote code, made its own decisions, and occasionally went rogue. We thought it was was great name for an AI that can learn on its own, so we kept Anton, dropped the "Son of".
187205

188206
---
189207

190208
## Analytics
191-
192209
Anton collects anonymous usage events (e.g. session started, first query) to help us understand how the product is used. No personal data or query content is sent.
193210

194211
To disable analytics, set the environment variable:
@@ -206,5 +223,4 @@ ANTON_ANALYTICS_ENABLED=false
206223
---
207224

208225
## License
209-
210226
AGPL-3.0 license

0 commit comments

Comments
 (0)