What is BeansHost?
BeansHost is a control plane for AI agents. You connect a GitHub repository, describe the agent in a beanshost.yaml file and deploy it to your own Vercel, Render, AWS or Azure account. BeansHost gives every agent an API endpoint and keeps deployments, runs, secrets, members, usage, approvals and audit events for your organization in one place.
Where do my agents run?
In your own cloud account. BeansHost deploys to Vercel, Render, Amazon ECS Express Mode or Azure Container Apps using the connection you authorize, so the infrastructure and its bill stay with you. BeansHost does not run your agent logic inside its control plane.
Which languages and frameworks can I deploy?
Any agent that answers HTTP requests and exposes a health path. JavaScript workers built on Web-standard APIs are packaged directly. Everything else runs as a container: if your repository has a Dockerfile, BeansHost uses it, and if not, BeansHost generates one for Node.js 22 or Python 3.12 with FastAPI, Flask or a plain script. No particular agent framework is required.
What is beanshost.yaml, and do I have to write it?
beanshost.yaml is the agent specification. It sets the runtime, entrypoint, health check, triggers, secrets, resilience, governance and observability settings. If your repository does not have one, BeansHost AI analyzes the repository, writes a starting file and commits it to the branch you chose so you can review and edit it like any other file.
How does my application call a deployed agent?
Every agent has its own HTTPS endpoint with Development and Production tabs in the console. Create an API key for that agent, then POST any JSON body to the endpoint. BeansHost applies your plan's rate limits, forwards the body unchanged and returns the agent's answer with an execution ID. The console gives you ready-made curl, JavaScript and Python snippets and an OpenAPI file.
Can I connect my agent from a third-party platform?
Yes. Any platform that can send an HTTPS request with a header can call your agent: your own backend, API clients such as Postman, API gateways, workflow and automation tools, partner systems or another agent. Create a key limited to that agent in the console, store it as a secret on the platform, and POST JSON to the agent's endpoint. You can also import the agent's OpenAPI 3.1 file instead of configuring the call by hand. Keep the key on a server, since browser requests from other websites are blocked.
What does BeansHost record about each run?
Metadata only: status, duration, provider, error category, byte counts and correlation IDs. Prompt and response content is never stored. Executions shows success rate, p95 duration and the most common failure, and Usage shows runs against your plan for the month.
Is there a free plan?
Creating an account and an organization is free. Connecting a repository or cloud account, registering agents, storing secrets, calling agents and deploying need the Builder plan at $5 per month or higher. Your cloud provider bills the infrastructure your agents use separately.
Which source control providers are supported?
GitHub is supported today, including private repositories. GitLab, Bitbucket and Azure DevOps are shown as coming soon in the console. Deployments are started from the console or the API; deploy on push is not available yet.
How are production releases governed?
Every member has one of seven roles, and privileged actions are written to an append-only audit log that you can filter and export as CSV. On Enterprise, production releases wait for approval from an owner or admin, who approves or denies with a reason. You can require that the person who requested a release cannot approve it.
Can I use a custom domain?
Not yet. Each agent is served on its provider URL and called through its BeansHost endpoint, and custom domains are not available in BeansHost today. You can still put your own gateway or domain in front of the BeansHost endpoint.