_____ _____ __ __
| | _ | | |
| | | | |- -|
|_|_|_|__|__|__|__|
[Max](https://max.cloud) connects to arbitrary sources of data, and synchronises that data into portable storage.
Once synced, queries run locally rather than against live APIs. This means that:
- Queries are instant
- There are no API rate limits
- There is no incremental cost per query
- Data sources take a familiar shape
## Install
```bash
curl -fsSL https://max.cloud/install.sh | sh
```
## Try it out
### On a public node
To get a feel for max, query live data on a public Max node:
```bash
# What are the most downloaded text-generation models?
max -t max://demo.max.cloud/max-demo/hf-popular search HfModel \
--filter 'pipelineTag = "text-generation" AND downloads > 10000' \
--order-by downloads:desc \
--fields id,downloads,likes
# Find open issues across a GitHub repo
max -t max://demo.max.cloud/max-demo/gh-pi-mono search GitHubIssue \
--filter 'state = "open"' \
--order-by createdAt:desc \
--fields title,author,state
# Show the schema for a node
max -t max://demo.max.cloud/max-demo/gh-pi-mono schema
```
### On your own data
```bash
# Add connectors from any collection
max -g install --collection git@github.com:max-hq/max-connectors.git
# Create a workspace
max init my-project && cd my-project
# Connect a source and and trigger a sync
max connect @max/connector-linear --name linear-1
max sync linear-1
# Query
max search linear-1 LinearIssue \
--filter 'state = "In Progress" AND labels ~= "bug"' \
--fields title,assignee,priority
```
## Give your agent access to max
```bash
max -g llm-bootstrap
```
This prints a context document that teaches your agent how to use Max. You can wrap this in a skill, or just tell the agent to run the command directly. Your agent can then explore (`max schema`, `max ls`), query (`max search`), and pipe output into its own tools.
## Storage model
Max's storage is modular by design - the first available module in this repo is `storage-sqlite`.
This means queries run (typically) locally with high throughput and low latency - and without rate-limits.
## Documentation and examples
**Documentation**: [docs.max.cloud](https://docs.max.cloud).
**Sample workspace**: `max://demo.max.cloud/max-demo` (use `max -t