Documentation: docs.toolfront.ai

Source code: https://github.com/statespace-tech/toolfront

Quickstart

ToolFront is a declarative framework for building modular AI applications in Markdown. Write tools and instructions in .md files, run the project, and get a live AI application.

Create it

Start with one file: README.md

---
tools:
  - [curl, -X, GET, "https://httpbin.org/status/200"]
---

# Status Checker
- Use `curl` to check if the service is up

Run it

Run the application with:

toolfront run .

Ask it

Ask your AI application.

from toolfront import Application

app = Application(url="http://127.0.0.1:8000")

result = app.ask("Is the service up?", model="openai:gpt-5")

print(result)
# Answer: yes

{
  "mcpServers": {
    "toolfront": {
      "command": "uvx",
      "args": ["toolfront", "mcp", "http://127.0.0.1:8000"]
    }
  }
}

Upgraded Example

Your full project can grow like this:

project/
├── README.md
├── src/
│   ├── api.md
│   ├── rag.md
│   ├── text2sql.md
│   └── toolkit.md
├── data/
└── tools/

Add Navigation

Update README.md with tools to explore the project

---
tools:
  - [curl, -X, GET, "https://httpbin.org/status/200"]
  - [ls]
  - [cat]
---

# Status Checker
- Use `curl` to check if the service is up
- Use `ls` and `cat` to browse other files

Add Document RAG

Give your agent tools to search documents

---
tools:
  - [grep]
---

# Search Docs
- Use `grep` to search files in `/data/`

Add Text-to-SQL

Connect your databases for SQL workflows

---
tools:
  - [psql, -U, $USER, -d, $DATABASE, -c, {query}]
---

# Database Access
- Call the `psql` tool to query the PostgreSQL database

Add Custom Tools

Build custom tools in any programming language

---
tools:
  - [python, tools/status.py, --delayed]
---

# Custom Tools
- Run `status.py` to check delayed orders

Installation

Install toolfront with your favorite PyPI package manager.

pip install toolfront

uv add toolfront

poetry add toolfront

Deploy your Apps

Instantly deploy your AI applications:

toolfront deploy ./path/to/project

Gives you a shareable application URL:

# Up to 5 public apps, totally free
app = Application("https://cloud.statespace.com/you/status-checker")

# Up to 20 public or private apps with authentication
app = Application("https://cloud.statespace.com/team/project", params={"API_KEY": "..."})

# Unlimited on-prem apps with Docker or K8s
app = Application("https://custom.com/agent")

Get started for free

Community & Contributing

• Discord: Join our community server for real-time help and discussions
• X: Follow us @toolfront for updates and news
• Issues: Report bugs or request features on GitHub Issues

License

This project is licensed under the terms of the MIT license.