Frequently Asked Questions
Find answers to common questions about Helpmaton
No FAQs found matching your search.
Getting Started
How do I create my first workspace?
Workspace creation
After signing up, you'll be prompted to create your first workspace. A workspace is like a container for your AI agents, documents, and team members.
Multiple workspaces allow you to organize different projects or client accounts, each with its own budget, permissions, and team members.
After signing up, you'll be prompted to create your first workspace. A workspace is like a container for your AI agents, documents, and team members.
Multiple workspaces allow you to organize different projects or client accounts, each with its own budget, permissions, and team members.
What do I need to get started?
Account setup
You need a Helpmaton account and either your own OpenRouter API key or you can purchase credits through Helpmaton.
OpenRouter keys are currently the only supported option for using your own API keys. Once you have a workspace, you can start creating agents and uploading documents.
For detailed setup instructions, see the Getting Started Guide.
You need a Helpmaton account and either your own OpenRouter API key or you can purchase credits through Helpmaton.
OpenRouter keys are currently the only supported option for using your own API keys. Once you have a workspace, you can start creating agents and uploading documents.
For detailed setup instructions, see the Getting Started Guide.
How do I create my first agent?
Agent creation
Navigate to your workspace, click 'Create Agent', give it a name and personality/instructions. You can configure tools, memory settings, and other options.
Immediate availability - Your agent will be ready to use immediately after creation. You can connect it to other apps and services right away.
Navigate to your workspace, click 'Create Agent', give it a name and personality/instructions. You can configure tools, memory settings, and other options.
Immediate availability - Your agent will be ready to use immediately after creation. You can connect it to other apps and services right away.
What's the difference between a workspace and an agent?
Workspaces vs Agents
Think of a workspace as a folder or project container. It holds your agents, documents, team members, and has its own budget and settings. You might have one workspace for personal projects and another for work.
An agent is an AI assistant that lives inside a workspace. Each agent has its own personality, memory, and capabilities. You can have multiple agents in one workspace - for example, one agent for customer support and another for research.
Think of a workspace as a folder or project container. It holds your agents, documents, team members, and has its own budget and settings. You might have one workspace for personal projects and another for work.
An agent is an AI assistant that lives inside a workspace. Each agent has its own personality, memory, and capabilities. You can have multiple agents in one workspace - for example, one agent for customer support and another for research.
What is OpenRouter and why do I need it?
OpenRouter explained
OpenRouter is a service that gives you access to multiple AI providers (like OpenAI, Anthropic, Google) through a single API key. It's like a universal adapter for AI services.
Why it matters - Helpmaton currently supports using your own API keys through OpenRouter. This lets you pay AI providers directly while using Helpmaton's platform. If you prefer not to manage API keys, you can purchase credits through Helpmaton instead.
OpenRouter is a service that gives you access to multiple AI providers (like OpenAI, Anthropic, Google) through a single API key. It's like a universal adapter for AI services.
Why it matters - Helpmaton currently supports using your own API keys through OpenRouter. This lets you pay AI providers directly while using Helpmaton's platform. If you prefer not to manage API keys, you can purchase credits through Helpmaton instead.
Agents
How does agent memory work?
How memory works
Agents remember important facts, people, and events from your conversations. They organize memories over time (daily, weekly, monthly, etc.) and use smart search to find relevant information from past conversations when answering questions.
Memory retention - Free plans retain 48 hours of recent memory plus 30 days of summaries, while Pro plans extend to 240 hours plus 120 days. Old memories are automatically cleaned up to save space.
Smart search helps agents give better answers by finding relevant information from past conversations, making responses more personalized and context-aware.
Learn more in the Agent Memory System documentation.
Agents remember important facts, people, and events from your conversations. They organize memories over time (daily, weekly, monthly, etc.) and use smart search to find relevant information from past conversations when answering questions.
Memory retention - Free plans retain 48 hours of recent memory plus 30 days of summaries, while Pro plans extend to 240 hours plus 120 days. Old memories are automatically cleaned up to save space.
Smart search helps agents give better answers by finding relevant information from past conversations, making responses more personalized and context-aware.
Learn more in the Agent Memory System documentation.
Can agents work together?
Agent delegation
Yes! Agents can delegate tasks to other agents in the same workspace. This enables complex multi-agent workflows where specialized agents handle different aspects of a task.
Multi-agent collaboration - You can set up teams of agents that collaborate on complex projects, with support for async delegation, query-based matching, and delegation tracking.
Yes! Agents can delegate tasks to other agents in the same workspace. This enables complex multi-agent workflows where specialized agents handle different aspects of a task.
Multi-agent collaboration - You can set up teams of agents that collaborate on complex projects, with support for async delegation, query-based matching, and delegation tracking.
What tools do agents have access to?
Built-in tools
Agents have powerful built-in tools: search your documents, recall past conversations, search the web for current information, extract content from web pages, send emails, send notifications to Discord or Slack, and delegate tasks to other agents.
External integrations - You can connect agents to external tools and services to extend their capabilities. Configure connections with authentication and enable them per-agent.
Agents have powerful built-in tools: search your documents, recall past conversations, search the web for current information, extract content from web pages, send emails, send notifications to Discord or Slack, and delegate tasks to other agents.
External integrations - You can connect agents to external tools and services to extend their capabilities. Configure connections with authentication and enable them per-agent.
How do I configure an agent's personality?
Custom instructions
When creating or editing an agent, you can set custom instructions that define its personality, behavior, and how it should respond.
Personality settings guide how the agent communicates and makes decisions, enabling you to create agents tailored to specific use cases and brand voices.
When creating or editing an agent, you can set custom instructions that define its personality, behavior, and how it should respond.
Personality settings guide how the agent communicates and makes decisions, enabling you to create agents tailored to specific use cases and brand voices.
What's the difference between web search and content extraction?
Web search vs content extraction
Web search lets your agent search the internet for current information, news, articles, and answers to questions. It's like giving your agent access to Google - perfect for finding the latest information.
Content extraction lets your agent read and summarize a specific web page when you give it a URL. It extracts the main content and can summarize it for you - perfect for analyzing articles or specific pages.
Both features help your agents access real-time information beyond their training data.
Web search lets your agent search the internet for current information, news, articles, and answers to questions. It's like giving your agent access to Google - perfect for finding the latest information.
Content extraction lets your agent read and summarize a specific web page when you give it a URL. It extracts the main content and can summarize it for you - perfect for analyzing articles or specific pages.
Both features help your agents access real-time information beyond their training data.
Workspaces
What are workspace credits used for?
AI provider costs
Workspace credits are used for AI provider calls (OpenRouter, OpenAI, Anthropic, Google, etc.), not for platform subscription costs.
Flexible billing - You can either provide your own OpenRouter API key (BYOK) and pay providers directly, or purchase credits through Helpmaton for usage-based billing with transparent pricing.
Workspace credits are used for AI provider calls (OpenRouter, OpenAI, Anthropic, Google, etc.), not for platform subscription costs.
Flexible billing - You can either provide your own OpenRouter API key (BYOK) and pay providers directly, or purchase credits through Helpmaton for usage-based billing with transparent pricing.
Can I use my own API keys?
Using your own API keys
Yes! You can use your own OpenRouter API keys, which is currently the only supported option for bringing your own keys.
Direct billing - When you add an OpenRouter API key to your workspace, requests use your key and you pay OpenRouter directly. Spending limits and usage tracking still apply so you can monitor costs and stay within your budget.
Yes! You can use your own OpenRouter API keys, which is currently the only supported option for bringing your own keys.
Direct billing - When you add an OpenRouter API key to your workspace, requests use your key and you pay OpenRouter directly. Spending limits and usage tracking still apply so you can monitor costs and stay within your budget.
How do spending limits work?
Granular control
You can set spending limits at both workspace and individual agent levels. Limits can be set for daily, monthly, or yearly periods.
Automatic protection - The system automatically prevents overspending by checking limits before processing requests. You'll always stay within your budget.
You can set spending limits at both workspace and individual agent levels. Limits can be set for daily, monthly, or yearly periods.
Automatic protection - The system automatically prevents overspending by checking limits before processing requests. You'll always stay within your budget.
How many team members can I add?
Team collaboration
Free plans support limited team members, while Pro plans support unlimited managers.
Permission levels - Team members can have different permission levels: READ (view only), WRITE (can make changes), and OWNER (full control). Pro plan subscriptions support multiple managers with shared access to all workspaces.
Free plans support limited team members, while Pro plans support unlimited managers.
Permission levels - Team members can have different permission levels: READ (view only), WRITE (can make changes), and OWNER (full control). Pro plan subscriptions support multiple managers with shared access to all workspaces.
What are external tool connections?
External tool connections explained
External tool connections let you connect your agents to other apps, services, and tools you already use. For example, you could connect an agent to your calendar app, email service, database, or any other service with an API.
Why it's useful - This extends what your agents can do. Instead of just answering questions, they can actually interact with your tools - schedule meetings, send emails, look up data, and more. It's like giving your agent hands to actually do things, not just talk.
External tool connections let you connect your agents to other apps, services, and tools you already use. For example, you could connect an agent to your calendar app, email service, database, or any other service with an API.
Why it's useful - This extends what your agents can do. Instead of just answering questions, they can actually interact with your tools - schedule meetings, send emails, look up data, and more. It's like giving your agent hands to actually do things, not just talk.
Billing & Pricing
What's included in my subscription?
Platform services
Your monthly subscription covers all Helpmaton platform services: hosting, agent configuration and management, memory system, analytics, workspaces, team collaboration, document storage, and all Helpmaton platform features.
What's included - Everything you need to run and manage your AI agents, including secure hosting, reliable infrastructure, and all platform features.
Your monthly subscription covers all Helpmaton platform services: hosting, agent configuration and management, memory system, analytics, workspaces, team collaboration, document storage, and all Helpmaton platform features.
What's included - Everything you need to run and manage your AI agents, including secure hosting, reliable infrastructure, and all platform features.
Are AI provider calls included in my subscription?
Separate costs
No, AI provider calls (OpenRouter, OpenAI, Anthropic, Google, etc.) are separate from your subscription.
Two options - You can either use your own OpenRouter API key and pay providers directly, or purchase credits through Helpmaton for usage-based billing. Credits are automatically managed to ensure accurate billing.
No, AI provider calls (OpenRouter, OpenAI, Anthropic, Google, etc.) are separate from your subscription.
Two options - You can either use your own OpenRouter API key and pay providers directly, or purchase credits through Helpmaton for usage-based billing. Credits are automatically managed to ensure accurate billing.
How much do web search calls cost?
Free daily allowance
All plans include 10 free web search calls per 24 hours. Additional calls are billed at $0.008 per call.
Transparent pricing - This gives you access to real-time information at a cost-effective rate, perfect for research assistants, news monitoring, and content analysis workflows.
All plans include 10 free web search calls per 24 hours. Additional calls are billed at $0.008 per call.
Transparent pricing - This gives you access to real-time information at a cost-effective rate, perfect for research assistants, news monitoring, and content analysis workflows.
What counts as an AI request?
Understanding AI requests
An AI request is each time your agent processes a message or question. Every conversation turn counts as one request - when you send a message and your agent responds, that's one request.
What's included - This includes all agent interactions: answering questions, searching documents, recalling memories, web searches, and any other task that requires the AI to process information and respond.
An AI request is each time your agent processes a message or question. Every conversation turn counts as one request - when you send a message and your agent responds, that's one request.
What's included - This includes all agent interactions: answering questions, searching documents, recalling memories, web searches, and any other task that requires the AI to process information and respond.
What are credits and how do they work?
Credits explained
Credits are like prepaid currency for AI usage. When you purchase credits through Helpmaton, you're buying a balance that gets used up as your agents make AI requests.
How it works - Each AI request costs a certain amount of credits based on the complexity and length. You can see exactly how much each request costs in your usage analytics. Credits are automatically deducted from your workspace balance as you use them.
Credits are like prepaid currency for AI usage. When you purchase credits through Helpmaton, you're buying a balance that gets used up as your agents make AI requests.
How it works - Each AI request costs a certain amount of credits based on the complexity and length. You can see exactly how much each request costs in your usage analytics. Credits are automatically deducted from your workspace balance as you use them.
Should I use my own API keys or purchase credits?
Choosing the right option
Use your own API keys if you already have accounts with AI providers (like OpenAI or Anthropic) and want to pay them directly. This gives you more control and you can take advantage of any discounts or credits you have with those providers.
Purchase credits if you want simplicity - just buy credits through Helpmaton and don't worry about managing multiple API keys. This is easier to get started with and you only need one payment method.
Both options give you access to all Helpmaton features. The choice is mainly about how you prefer to handle billing.
Use your own API keys if you already have accounts with AI providers (like OpenAI or Anthropic) and want to pay them directly. This gives you more control and you can take advantage of any discounts or credits you have with those providers.
Purchase credits if you want simplicity - just buy credits through Helpmaton and don't worry about managing multiple API keys. This is easier to get started with and you only need one payment method.
Both options give you access to all Helpmaton features. The choice is mainly about how you prefer to handle billing.
How does credit reservation work?
Automatic credit management
Before making an AI request, the system estimates the cost and reserves credits from your workspace balance. After the request completes, it calculates the actual cost and adjusts the reservation automatically.
Accurate billing - This ensures you're always charged accurately and prevents overspending. If the actual cost is less than estimated, you get a refund. If it's more, you're charged the difference.
Learn more in the Credit System documentation.
Before making an AI request, the system estimates the cost and reserves credits from your workspace balance. After the request completes, it calculates the actual cost and adjusts the reservation automatically.
Accurate billing - This ensures you're always charged accurately and prevents overspending. If the actual cost is less than estimated, you get a refund. If it's more, you're charged the difference.
Learn more in the Credit System documentation.
What does 'subscription sharing' mean?
Subscription sharing explained
Subscription sharing (available on Pro plans) lets multiple people manage the same Helpmaton account. All managers have access to all workspaces and can create agents, manage settings, and collaborate together.
Why it's useful - Perfect for teams where multiple people need to manage AI agents. Instead of each person having their own account, you can share one Pro subscription and work together on all your workspaces and agents.
Subscription sharing (available on Pro plans) lets multiple people manage the same Helpmaton account. All managers have access to all workspaces and can create agents, manage settings, and collaborate together.
Why it's useful - Perfect for teams where multiple people need to manage AI agents. Instead of each person having their own account, you can share one Pro subscription and work together on all your workspaces and agents.
What does 'working memory' and 'summaries' mean?
Memory types explained
Working memory is the detailed, recent memory your agent has. It remembers specific facts, conversations, and details from the past 48 hours (Free) or 240 hours (Pro). This is like short-term memory - very detailed but recent.
Summaries are condensed versions of older memories. After the working memory period, conversations are summarized and kept for 30 days (Free) or 120 days (Pro). These summaries capture the key points but not every detail - like long-term memory.
This system helps agents remember important information while keeping storage efficient.
Working memory is the detailed, recent memory your agent has. It remembers specific facts, conversations, and details from the past 48 hours (Free) or 240 hours (Pro). This is like short-term memory - very detailed but recent.
Summaries are condensed versions of older memories. After the working memory period, conversations are summarized and kept for 30 days (Free) or 120 days (Pro). These summaries capture the key points but not every detail - like long-term memory.
This system helps agents remember important information while keeping storage efficient.
API & Integrations
How do I access the API?
API for developers
Helpmaton provides a comprehensive API with full documentation. You can authenticate using several methods: web sessions, API tokens, workspace API keys, or OAuth.
Complete documentation - Full API documentation is available. Generate client libraries, explore endpoints, and understand how to integrate at the API Reference.
See also the API Reference documentation in the repository.
Helpmaton provides a comprehensive API with full documentation. You can authenticate using several methods: web sessions, API tokens, workspace API keys, or OAuth.
Complete documentation - Full API documentation is available. Generate client libraries, explore endpoints, and understand how to integrate at the API Reference.
See also the API Reference documentation in the repository.
Can I set up webhooks?
App connections
Yes! Every agent can connect to other apps and services. Send messages and receive AI-powered responses, making integration with your applications straightforward.
Real-time responses - Supports both standard responses and real-time streaming for instant updates as your agent works.
Yes! Every agent can connect to other apps and services. Send messages and receive AI-powered responses, making integration with your applications straightforward.
Real-time responses - Supports both standard responses and real-time streaming for instant updates as your agent works.
What are MCP servers?
External tool connections
You can extend your agents' capabilities by connecting them to external tools, databases, and services. This lets your agents access information and perform actions beyond their built-in capabilities.
Configuration - Configure connections with authentication settings and enable them per-agent. Your agents will automatically have access to the tools you connect.
See the integration documentation for detailed setup instructions.
You can extend your agents' capabilities by connecting them to external tools, databases, and services. This lets your agents access information and perform actions beyond their built-in capabilities.
Configuration - Configure connections with authentication settings and enable them per-agent. Your agents will automatically have access to the tools you connect.
See the integration documentation for detailed setup instructions.
How do I connect my agents to Gmail, Google Calendar, or Google Drive?
Easy OAuth setup
Connect your agents to Google Workspace services with just a few clicks. No complex configuration or API keys needed—just connect your Google account.
Setup process - Go to "Integrations" in your workspace, create an MCP server for the Google service you want (Gmail, Calendar, or Drive), click "Connect Google Account", sign in, and grant permissions. Enable the connection for your agents and you're done!
What agents can do - Gmail: search and read emails using Gmail's powerful search. Google Calendar: manage events, create meetings, and update schedules. Google Drive: read files, Docs, Sheets, and Slides for document analysis.
Secure by default - All connections use OAuth 2.0 authentication to keep your data private and secure.
Connect your agents to Google Workspace services with just a few clicks. No complex configuration or API keys needed—just connect your Google account.
Setup process - Go to "Integrations" in your workspace, create an MCP server for the Google service you want (Gmail, Calendar, or Drive), click "Connect Google Account", sign in, and grant permissions. Enable the connection for your agents and you're done!
What agents can do - Gmail: search and read emails using Gmail's powerful search. Google Calendar: manage events, create meetings, and update schedules. Google Drive: read files, Docs, Sheets, and Slides for document analysis.
Secure by default - All connections use OAuth 2.0 authentication to keep your data private and secure.
How do I connect my agents to Notion?
Easy OAuth setup
Connect your agents to Notion with just a few clicks. No complex configuration or API keys needed—just connect your Notion account.
Setup process - Go to "Integrations" in your workspace, create an MCP server and select "Notion", click "Connect Notion Account", sign in, and grant permissions. Enable the connection for your agents and you're done!
What agents can do - Read and search pages across your Notion workspace. Create and update pages with content and properties. Query databases with filters and sorts. Create and update database pages. Append blocks (paragraphs, headings, lists) to existing pages. Perfect for knowledge management, documentation, and content workflows.
Secure by default - All connections use OAuth authentication to keep your data private and secure.
Connect your agents to Notion with just a few clicks. No complex configuration or API keys needed—just connect your Notion account.
Setup process - Go to "Integrations" in your workspace, create an MCP server and select "Notion", click "Connect Notion Account", sign in, and grant permissions. Enable the connection for your agents and you're done!
What agents can do - Read and search pages across your Notion workspace. Create and update pages with content and properties. Query databases with filters and sorts. Create and update database pages. Append blocks (paragraphs, headings, lists) to existing pages. Perfect for knowledge management, documentation, and content workflows.
Secure by default - All connections use OAuth authentication to keep your data private and secure.
How do I deploy agents as Slack or Discord bots?
Chat platform integration
Go to the Integrations page in your workspace. For Slack, you can generate an app configuration for easy setup. For Discord, you'll configure slash commands.
Secure by default - Both platforms use secure verification to ensure only legitimate requests are processed. Bots provide real-time responses and have access to all agent tools, memory, and knowledge bases.
See the Slack Integration guide and Discord Integration guide for detailed setup instructions.
Go to the Integrations page in your workspace. For Slack, you can generate an app configuration for easy setup. For Discord, you'll configure slash commands.
Secure by default - Both platforms use secure verification to ensure only legitimate requests are processed. Bots provide real-time responses and have access to all agent tools, memory, and knowledge bases.
See the Slack Integration guide and Discord Integration guide for detailed setup instructions.
What does it mean to deploy an agent as a Slack or Discord bot?
Chat bot deployment explained
When you deploy an agent as a Slack or Discord bot, your AI agent becomes a member of your chat channel. Team members can talk to it directly in Slack or Discord, just like messaging a person.
What it enables - Your team can ask questions, get help, or interact with your agent without leaving Slack or Discord. The agent responds in real-time, remembers conversations, and can use all its tools (search documents, web search, etc.) right in the chat.
It's like having an AI assistant that lives in your team's chat room, always available to help.
When you deploy an agent as a Slack or Discord bot, your AI agent becomes a member of your chat channel. Team members can talk to it directly in Slack or Discord, just like messaging a person.
What it enables - Your team can ask questions, get help, or interact with your agent without leaving Slack or Discord. The agent responds in real-time, remembers conversations, and can use all its tools (search documents, web search, etc.) right in the chat.
It's like having an AI assistant that lives in your team's chat room, always available to help.
Technical
How are errors handled?
Automatic error tracking
When something goes wrong, you'll see it immediately. All conversations are saved and errors are clearly marked with detailed information about what happened.
Error visibility - Error badges appear in conversation lists for quick identification, and detailed error views help you quickly identify and fix issues. All errors are tracked so you can see patterns over time.
When something goes wrong, you'll see it immediately. All conversations are saved and errors are clearly marked with detailed information about what happened.
Error visibility - Error badges appear in conversation lists for quick identification, and detailed error views help you quickly identify and fix issues. All errors are tracked so you can see patterns over time.
What file formats are supported for documents?
Document management
Helpmaton supports markdown and text documents. You can upload documents and organize them in folders.
Smart search - Your agents can search through these documents using intelligent search that understands meaning, not just keywords. This helps them provide better, more informed responses.
Helpmaton supports markdown and text documents. You can upload documents and organize them in folders.
Smart search - Your agents can search through these documents using intelligent search that understands meaning, not just keywords. This helps them provide better, more informed responses.
How does web search work?
Real-time information access
Agents can search the web for current information, news, and articles using the search_web tool. They can also extract and summarize content from any web page URL using the fetch_web tool.
Easy enablement - Both features can be enabled per-agent with simple toggle switches. Perfect for research assistants, news monitoring, and content analysis workflows.
Agents can search the web for current information, news, and articles using the search_web tool. They can also extract and summarize content from any web page URL using the fetch_web tool.
Easy enablement - Both features can be enabled per-agent with simple toggle switches. Perfect for research assistants, news monitoring, and content analysis workflows.
What infrastructure does Helpmaton use?
Reliable cloud infrastructure
Helpmaton is built on modern cloud infrastructure designed for reliability, security, and scalability. All data is encrypted and stored securely.
High availability - The platform automatically scales to handle your usage and is designed for high availability. Your agents are always available when you need them.
Region - Deployed in London (eu-west-2) with automatic scaling and redundancy built in.
See the Architecture Overview for detailed technical information.
Helpmaton is built on modern cloud infrastructure designed for reliability, security, and scalability. All data is encrypted and stored securely.
High availability - The platform automatically scales to handle your usage and is designed for high availability. Your agents are always available when you need them.
Region - Deployed in London (eu-west-2) with automatic scaling and redundancy built in.
See the Architecture Overview for detailed technical information.
How does usage analytics work?
Comprehensive tracking
Helpmaton tracks all your AI usage comprehensively. Data is aggregated daily and hourly, with historical data available through date range filtering.
Detailed breakdowns - You can view usage and costs broken down per-workspace or per-agent. See exactly where your usage is going and optimize accordingly.
Helpmaton tracks all your AI usage comprehensively. Data is aggregated daily and hourly, with historical data available through date range filtering.
Detailed breakdowns - You can view usage and costs broken down per-workspace or per-agent. See exactly where your usage is going and optimize accordingly.
Self-Hosting & Open Source
Is Helpmaton open source?
Source-available license
Yes! Helpmaton is licensed under the Business Source License 1.1, making the source code available for evaluation, internal use, and contribution.
License terms - The license protects the ability to offer it as a commercial hosted service until November 1st, 2029, when it will automatically convert to Apache License 2.0. You can view, modify, and contribute to the code on GitHub.
See the LICENSE file for full license terms.
Yes! Helpmaton is licensed under the Business Source License 1.1, making the source code available for evaluation, internal use, and contribution.
License terms - The license protects the ability to offer it as a commercial hosted service until November 1st, 2029, when it will automatically convert to Apache License 2.0. You can view, modify, and contribute to the code on GitHub.
See the LICENSE file for full license terms.
What license does Helpmaton use?
Business Source License 1.1
Helpmaton uses the Business Source License 1.1, which makes the software source-available while protecting commercial hosting rights until the Change Date.
Change Date - On November 1st, 2029, the license automatically converts to Apache License 2.0, making it fully open source. Until then, you cannot provide Helpmaton as a hosted SaaS offering to third parties, but internal use and self-hosting for your own business is permitted.
Read the full license terms in the LICENSE.md file.
Helpmaton uses the Business Source License 1.1, which makes the software source-available while protecting commercial hosting rights until the Change Date.
Change Date - On November 1st, 2029, the license automatically converts to Apache License 2.0, making it fully open source. Until then, you cannot provide Helpmaton as a hosted SaaS offering to third parties, but internal use and self-hosting for your own business is permitted.
Read the full license terms in the LICENSE.md file.
Can I self-host Helpmaton?
Full self-hosting support
Yes! The complete source code is available on GitHub, so you can spin up your own instance, customize it to your needs, and run it on your own infrastructure.
Infrastructure requirements - You'll need AWS account with Lambda, DynamoDB, S3, API Gateway, CloudFront, and Route53. The platform uses Architect Framework for deployment. See the deployment documentation for detailed setup instructions.
Full control - Self-hosting gives you complete control over your data, infrastructure, and customization, with zero vendor lock-in.
Yes! The complete source code is available on GitHub, so you can spin up your own instance, customize it to your needs, and run it on your own infrastructure.
Infrastructure requirements - You'll need AWS account with Lambda, DynamoDB, S3, API Gateway, CloudFront, and Route53. The platform uses Architect Framework for deployment. See the deployment documentation for detailed setup instructions.
Full control - Self-hosting gives you complete control over your data, infrastructure, and customization, with zero vendor lock-in.
What do I need to self-host Helpmaton?
Infrastructure setup
You'll need an AWS account with access to Lambda, DynamoDB, S3, API Gateway, CloudFront, Route53, and ACM (for SSL certificates). The platform is designed for AWS serverless infrastructure.
Development setup - Local development uses Architect Sandbox (DynamoDB emulator) and s3rver (local S3). See the development setup guide for detailed instructions.
Deployment - Automated deployment via GitHub Actions or manual deployment using Architect Framework. All required environment variables and secrets are documented in the deployment guide.
You'll need an AWS account with access to Lambda, DynamoDB, S3, API Gateway, CloudFront, Route53, and ACM (for SSL certificates). The platform is designed for AWS serverless infrastructure.
Development setup - Local development uses Architect Sandbox (DynamoDB emulator) and s3rver (local S3). See the development setup guide for detailed instructions.
Deployment - Automated deployment via GitHub Actions or manual deployment using Architect Framework. All required environment variables and secrets are documented in the deployment guide.
How does the vector database work?
How memory storage works
Agent memory is stored efficiently using specialized databases. Each agent organizes memories by time periods (daily, weekly, monthly, quarterly, yearly) to make searching fast and relevant.
Reliable storage - The system ensures data is written safely and consistently, preventing any data loss or corruption.
Fast retrieval - Smart search technology enables agents to quickly find relevant information from past conversations, making responses more context-aware and helpful.
See the technical documentation for complete technical details.
Agent memory is stored efficiently using specialized databases. Each agent organizes memories by time periods (daily, weekly, monthly, quarterly, yearly) to make searching fast and relevant.
Reliable storage - The system ensures data is written safely and consistently, preventing any data loss or corruption.
Fast retrieval - Smart search technology enables agents to quickly find relevant information from past conversations, making responses more context-aware and helpful.
See the technical documentation for complete technical details.