Skip to content

Commit 4c26026

Browse files
authored
Merge pull request #98 from mindsdb/update-readme-positioning-v2
docs: Reposition README - Anton as a general-purpose autonomous agent
2 parents a0a7241 + 6c6c8dc commit 4c26026

1 file changed

Lines changed: 55 additions & 45 deletions

File tree

README.md

Lines changed: 55 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,3 @@
1-
<div align="center">
2-
<a href="https://www.producthunt.com/products/mindsdb?embed=true&amp;utm_source=badge-featured&amp;utm_medium=badge&amp;utm_campaign=badge-mindsdb-anton-2" target="_blank" rel="noopener noreferrer"><img alt="MindsDB Anton - Business intelligence that doesn't just answer — it acts. | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1115197&amp;theme=light&amp;t=1775607473112"></a>
3-
</div>
4-
5-
<br>
6-
71
```
82
93
▄█▀██▀█▄ ♡♡♡♡
@@ -12,18 +6,14 @@
126
▐ ▐ █▀█ █ ▀█ █ █▄█ █ ▀█
137
▐ ▐
148
```
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.
1511

16-
# MindsDB Anton — What Business Intelligence is supposed to be
17-
18-
Business intelligence was supposed to give you the right data, at the right time, to get real work done.
19-
20-
That is Anton. You ask questions in plain language, and Anton takes ownership of the entire analytical process:
21-
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.
2213

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

25-
26-
## Quick start
16+
## Quick start
2717
**macOS - Desktop App:**
2818

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

51-
## 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.
5244

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

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

61-
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.
6255

6356

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

73-
**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 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
7494
- **Credential vault** - prevents secrets from being exposed to LLMs.
75-
- **Isolated code execution** - protected, reproducible “show your work” environment.
76-
- **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+
---
7799

78100
#### Connect your data
79-
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.
80102

81103
```powershell
82104
/connect
@@ -116,32 +138,28 @@ ANTON>
116138

117139
---
118140

119-
### Explainable by default
120-
121-
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.
122142

123143
---
124144

125145
## What's inside
126-
127146
<p align="center"><img width="800" alt="image" src="/assets/anton-diagram.png" /></p>
128147

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

131150
---
132151

133152
## Workspace layout
134-
135153
When you run `anton` in a directory:
136154

137-
- `.anton/` workspace folder containing scratchpad state, episodic memory, and local secrets.
138-
- `.anton/anton.md` optional project context (Anton reads this at conversation start).
139-
- `.anton/.env` workspace configuration variables file (local file).
140-
- `.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.
141159
- `.anton/memory/rules.md` - behavioral rules: Always/never/when rules (e.g., never hardcode credentials, how to build HTML)
142160
- `.anton/memory/lessons.md` - factual knowledge: Things I've learned (stock API quirks, dashboard patterns, data fetching notes)
143161
- `.anton/memory/topics/*` - topic-specific lessons: Deeper notes organized by subject (dashboard-visualization, stock-data-api, etc.)
144-
162+
145163
Override the working folder:
146164
```bash
147165
anton --folder /path/to/workspace
@@ -150,25 +168,22 @@ anton --folder /path/to/workspace
150168
---
151169

152170
## Memory systems
153-
154171
Anton provides two human-readable memory systems:
155172

156-
- **Semantic memory** rules, lessons, identity and domain expertise stored as markdown at global and project scope.
157-
- **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.
158175

159176
Configure memory via `/setup` > Memory or via environment variables.
160177

161178
---
162179

163180
### Prerequisites
164-
165-
- `git` — required
181+
- `git` - required
166182
- Python **3.11+** (Anton will bootstrap an environment if missing)
167-
- `curl` macOS / Linux installs
183+
- `curl` - macOS / Linux installs
168184
- Internet connection (scratchpad may access web sources)
169185

170186
### Windows scratchpad firewall
171-
172187
The Windows installer can add a firewall rule so the scratchpad can reach the internet. If you skipped it, run in an elevated PowerShell:
173188

174189
```powershell
@@ -178,23 +193,19 @@ netsh advfirewall firewall add rule name="Anton Scratchpad" dir=out action=allow
178193
---
179194

180195
## How Anton differs from coding agents
181-
182-
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.
183197

184198
---
185199

186200
## Is "Anton" a Mind?
187-
188201
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 :)
189202

190203
## Why the name "Anton"?
191-
192-
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".
193205

194206
---
195207

196208
## Analytics
197-
198209
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.
199210

200211
To disable analytics, set the environment variable:
@@ -212,5 +223,4 @@ ANTON_ANALYTICS_ENABLED=false
212223
---
213224

214225
## License
215-
216226
AGPL-3.0 license

0 commit comments

Comments
 (0)