scout

Name: scout
Author: agno-agi

byagno-agi· 4 MCP servers

Stars

680

Forks

How to install scout?

agno-agi/scout

$git clone https://github.com/agno-agi/scout

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install scout by running `git clone https://github.com/agno-agi/scout`, then use it for the current task and follow its documentation at https://github.com/agno-agi/scout.

Files · 1

View on GitHub

README.md

1	# Scout: Company Intelligence Agent
2
3	Scout is an open-source company intelligence agent. It navigates live information sources (web, slack, drive, wiki, CRM, MCP servers) to assemble context on demand - and builds its own wiki and CRM as it learns about your company.
4
5	YC's Summer 2026 RFS named "Company Brain" and "AI Operating System for Companies" — the same idea from two angles: pull knowledge out of fragmented sources and turn it into something AI can act on. The brain is the data layer. The OS runs on top of it. Neither exists as a finished product today, but the pieces do.
6
7	Scout stitches them together using patterns that already work: navigation over search, context providers, agentic SQL, and persistent memory.
8
9	Navigation over search. The default move when working with knowledge sources is to ingest everything into a vector db, chunk, embed, and pray. There are many reasons this doesn't work. Coding agents figured out the right approach. They navigate: `ls`, `grep`, open the file, follow the import. Scout does the same thing across Slack, Drive, and the rest.
10
11	Scout maintains its own wiki and CRM. Most information Scout learns from working with you is perfect for a wiki and CRM. "Josh from Anthropic shared a new RLM paper". Scout adds Josh to the CRM, parses the paper into the wiki, and links them.
12
13	## Quick start
14
15	> Prerequisite: Docker Desktop installed and running ([install guide](https://docs.docker.com/desktop/)).
16
17	```sh
18	git clone https://github.com/agno-agi/scout && cd scout
19
20	cp example.env .env
21	# set OPENAI_API_KEY in .env
22
23	docker compose up -d --build
24	```
25
26	Scout is now running at `http://localhost:8000`.
27
28	## Chat with Scout
29
30	1. Open [os.agno.com](https://os.agno.com?utm_source=github&utm_medium=example-repo&utm_campaign=agent-example&utm_content=scout&utm_term=agentos) and log in.
31	2. Click Add OS, choose Local, enter http://localhost:8000, then Connect.
32	3. Try the pre-configured prompts.
33
34	https://github.com/user-attachments/assets/ed49a6c4-926b-4d5d-a105-8a0d15021d3b
35
36	## Chat with Scout in Slack
37
38	Scout is designed to live in Slack as your teammate. Follow [docs/SLACK_CONNECT.md](docs/SLACK_CONNECT.md) to add Scout to your slack workspace.
39
40	https://github.com/user-attachments/assets/69d1c409-ff94-4c8e-b5e8-64c6e1a0518a
41
42	## How Scout works
43
44	Scout is a single agent with multiple context providers. Each context provider exposes 2 natural-language tools to interact with an information source:
45
46	- `query_<source>`: reads
47	- `update_<source>`: writes (when supported)
48
49	This thin layer solves three problems that hit any agent with a diverse tool surface: context pollution from too many tools, degrading performance from overlapping scopes, and the main agent forgetting its job because its context is all tool quirks.
50
51	The win is that a sub-agent behind each provider owns the source's quirks. Scout sees `query_slack`. Behind it, a sub-agent knows to look up the user before DMing, paginate by cursor, and prefer `conversations.replies` for threads. Scout's context never sees any of that.
52
53	> "Find the latest benchmark numbers for model X." → `query_web`, cites sources.
54	>
55	> "Save that as a note." → `update_crm` → write sub-agent `INSERT`s into `scout.scout_notes`.
56	>
57	> "File a runbook for incident response." → `update_knowledge` → wiki sub-agent writes a markdown page under `wiki/knowledge/runbooks/`.
58	>
59	> "Track my coffee consumption: flat white, extra shot." → `update_crm` → write sub-agent creates `scout.scout_coffee_orders` and inserts the row. Schema on demand.
60	>
61	> "Draft a Slack message announcing the launch." → `query_voice` first to load the style guide, then drafts in that voice.
62
63	## Context Providers
64
65	A `ContextProvider` exposes an information source to the agent.
66
67	\| Provider \| Trigger \| Tools \|
68	\|---\|---\|---\|
69	\| `WebContextProvider` \| always on \| `query_web` \|
70	\| `WorkspaceContextProvider` \| always on \| `query_workspace` — rooted at the scout repo, so Scout can a

6 picks

Type

scout

byagno-agi· 4 MCP servers

Stars

680

Forks

How to install scout?

agno-agi/scout

$git clone https://github.com/agno-agi/scout

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install scout by running `git clone https://github.com/agno-agi/scout`, then use it for the current task and follow its documentation at https://github.com/agno-agi/scout.

Files · 1

View on GitHub

README.md

1	# Scout: Company Intelligence Agent
2
3	Scout is an open-source company intelligence agent. It navigates live information sources (web, slack, drive, wiki, CRM, MCP servers) to assemble context on demand - and builds its own wiki and CRM as it learns about your company.
4
5	YC's Summer 2026 RFS named "Company Brain" and "AI Operating System for Companies" — the same idea from two angles: pull knowledge out of fragmented sources and turn it into something AI can act on. The brain is the data layer. The OS runs on top of it. Neither exists as a finished product today, but the pieces do.
6
7	Scout stitches them together using patterns that already work: navigation over search, context providers, agentic SQL, and persistent memory.
8
9	Navigation over search. The default move when working with knowledge sources is to ingest everything into a vector db, chunk, embed, and pray. There are many reasons this doesn't work. Coding agents figured out the right approach. They navigate: `ls`, `grep`, open the file, follow the import. Scout does the same thing across Slack, Drive, and the rest.
10
11	Scout maintains its own wiki and CRM. Most information Scout learns from working with you is perfect for a wiki and CRM. "Josh from Anthropic shared a new RLM paper". Scout adds Josh to the CRM, parses the paper into the wiki, and links them.
12
13	## Quick start
14
15	> Prerequisite: Docker Desktop installed and running ([install guide](https://docs.docker.com/desktop/)).
16
17	```sh
18	git clone https://github.com/agno-agi/scout && cd scout
19
20	cp example.env .env
21	# set OPENAI_API_KEY in .env
22
23	docker compose up -d --build
24	```
25
26	Scout is now running at `http://localhost:8000`.
27
28	## Chat with Scout
29
30	1. Open [os.agno.com](https://os.agno.com?utm_source=github&utm_medium=example-repo&utm_campaign=agent-example&utm_content=scout&utm_term=agentos) and log in.
31	2. Click Add OS, choose Local, enter http://localhost:8000, then Connect.
32	3. Try the pre-configured prompts.
33
34	https://github.com/user-attachments/assets/ed49a6c4-926b-4d5d-a105-8a0d15021d3b
35
36	## Chat with Scout in Slack
37
38	Scout is designed to live in Slack as your teammate. Follow [docs/SLACK_CONNECT.md](docs/SLACK_CONNECT.md) to add Scout to your slack workspace.
39
40	https://github.com/user-attachments/assets/69d1c409-ff94-4c8e-b5e8-64c6e1a0518a
41
42	## How Scout works
43
44	Scout is a single agent with multiple context providers. Each context provider exposes 2 natural-language tools to interact with an information source:
45
46	- `query_<source>`: reads
47	- `update_<source>`: writes (when supported)
48
49	This thin layer solves three problems that hit any agent with a diverse tool surface: context pollution from too many tools, degrading performance from overlapping scopes, and the main agent forgetting its job because its context is all tool quirks.
50
51	The win is that a sub-agent behind each provider owns the source's quirks. Scout sees `query_slack`. Behind it, a sub-agent knows to look up the user before DMing, paginate by cursor, and prefer `conversations.replies` for threads. Scout's context never sees any of that.
52
53	> "Find the latest benchmark numbers for model X." → `query_web`, cites sources.
54	>
55	> "Save that as a note." → `update_crm` → write sub-agent `INSERT`s into `scout.scout_notes`.
56	>
57	> "File a runbook for incident response." → `update_knowledge` → wiki sub-agent writes a markdown page under `wiki/knowledge/runbooks/`.
58	>
59	> "Track my coffee consumption: flat white, extra shot." → `update_crm` → write sub-agent creates `scout.scout_coffee_orders` and inserts the row. Schema on demand.
60	>
61	> "Draft a Slack message announcing the launch." → `query_voice` first to load the style guide, then drafts in that voice.
62
63	## Context Providers
64
65	A `ContextProvider` exposes an information source to the agent.
66
67	\| Provider \| Trigger \| Tools \|
68	\|---\|---\|---\|
69	\| `WebContextProvider` \| always on \| `query_web` \|
70	\| `WorkspaceContextProvider` \| always on \| `query_workspace` — rooted at the scout repo, so Scout can a

6 picks

Type

scout

How to install scout?

Related

scout

How to install scout?

Related