Skip to content

djinilabs/helpmaton

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Helpmaton Logo

Helpmaton

Deploy and manage AI agents with ease

Helpmaton is a workspace-based platform that empowers you to create, configure, and deploy AI agents for your applications. Organize your agents, manage knowledge bases, and integrate seamlessly through webhooks and APIs.

Try Helpmaton now →

What is Helpmaton?

Helpmaton is a comprehensive AI agent management platform designed for teams and developers who need to deploy intelligent assistants at scale. Whether you're building customer support bots, internal knowledge assistants, or specialized AI workflows, Helpmaton provides the infrastructure and tools to make it happen.

Available as a fully managed SaaS platform at helpmaton.com, you can get started in minutes without any infrastructure setup.

Core Concept

Create workspaces to organize your AI agents and their knowledge bases. Each agent can be configured with custom system prompts and has access to documents you upload, enabling context-aware responses tailored to your specific use case. Agents expose webhook endpoints that can be integrated into any application or service.

Use Cases

  • Customer Support: Deploy intelligent support agents that understand your product documentation
  • Internal Knowledge Bases: Create assistants that help teams find information quickly
  • Chat Platform Bots: Deploy your agents as Slack or Discord bots for team collaboration and community engagement
  • Research Assistants: Build agents that can search the web for current information, find recent articles, and analyze web content
  • News Monitoring: Create agents that monitor news, track industry developments, and provide real-time updates
  • Content Analysis: Deploy agents that extract and summarize content from web pages, articles, and online resources
  • Specialized Workflows: Build domain-specific agents for technical documentation, legal research, or any specialized field
  • API Integration: Embed AI capabilities into your applications via webhook endpoints

Key Features

Workspace Organization

Organize your agents and documents into workspaces. Perfect for teams managing multiple projects or departments, each with their own isolated environment.

AI Agent Management

Create and configure AI agents with custom system prompts. Define their behavior, personality, and response style. Each agent gets its own webhook endpoint for easy integration.

Document Management

Upload markdown and text documents to build knowledge bases for your agents. Organize documents into folders and keep them updated as your information evolves.

Agent Memory System

Agents remember important facts, people, and events from conversations through a stratified memory architecture. Memories are progressively summarized across temporal grains (daily, weekly, monthly, quarterly, yearly) and searchable via semantic vector search, enabling context-aware responses informed by past interactions.

Web Search & Content Extraction

Give your agents access to real-time, up-to-date information beyond their training data. Enable web search and content extraction tools to make your AI assistants more capable and current.

Web Search (search_web): Agents can search the web for current information, news, articles, and research. Perfect for finding the latest developments, answering questions about recent events, or discovering new resources. Search results include titles, URLs, content snippets, and relevance scores.

Content Extraction (fetch_url): Extract and summarize content from any web page URL. Agents can read and understand specific web pages, analyze articles, extract key information, and provide insights from any online content.

Key Advantages:

  • Real-Time Information: Access current information that isn't in training data
  • Always Current: Answer questions about recent events, news, and developments
  • Cost-Effective: Free daily allowance (10 calls/day) with transparent pay-as-you-go pricing ($0.008 per additional call)
  • Easy Integration: Enable per-agent with simple toggle switches
  • Intelligent Extraction: Automatically extracts main content, titles, and metadata from web pages

Pricing: Free tier includes 10 calls per 24 hours. Paid tiers get 10 free calls per day, then $0.008 per additional call. Perfect for research assistants, news monitoring, and content analysis workflows.

Tool Integration & Extensibility

Agents come with a comprehensive set of built-in tools and can be extended with MCP (Model Context Protocol) servers to connect to external APIs and services.

Built-in Tools:

  • Document Search: Semantic vector search across workspace documents
  • Memory Search: Recall past conversations and information from the agent's memory system
  • Web Search: Search the web for current information, news, and articles
  • Web Fetch: Extract and summarize content from any web page URL
  • Email Sending: Send emails using workspace email connections
  • Notification Sending: Send notifications to Discord channels (with API support for Slack)
  • Agent Delegation: Agents can delegate tasks to other agents in the workspace, with support for async delegation, query-based matching, and delegation tracking

Extensibility: Configure MCP servers with custom authentication and enable them per-agent to give your AI assistants access to databases, business logic, weather APIs, and any other external services you need.

Cost Management & Billing

Credit System: Purchase credits and pay only for what you use with transparent, usage-based billing. Credits are automatically reserved before LLM calls and adjusted after based on actual token usage, with atomic operations preventing race conditions.

Bring Your Own Key (BYOK): Use your own LLM API keys instead of credits. Pay providers directly while still benefiting from Helpmaton's infrastructure, analytics, and management features.

Spending Limits: Set granular daily, monthly, or yearly spending limits at both workspace and individual agent levels to prevent runaway costs and maintain budget control.

Advanced Pricing: Support for tiered pricing models (different rates based on token thresholds), separate reasoning token billing, and tracking of cached prompt tokens for accurate cost calculation.

Usage Analytics & Monitoring

Comprehensive token usage tracking across all dimensions: prompt tokens, completion tokens, reasoning tokens, and cached tokens. View detailed usage statistics with daily and hourly aggregation, historical data with date range filtering, and per-workspace or per-agent breakdowns.

Error Tracking: Conversations automatically persist and display errors when LLM calls fail, including detailed error messages, stack traces, provider information, and metadata. Error badges in conversation lists and detailed error views help you quickly identify and debug issues.

Trial & Free Access

Request trial credits to test the platform risk-free. The free plan includes 1 workspace and 1 agent with 7-day access, perfect for evaluation. After the trial period, agents are blocked until you upgrade to a paid plan.

Flexible Authentication

Multiple authentication methods to fit your workflow: session-based authentication for web users, JWT tokens with 24-hour expiration for API access, workspace API keys for programmatic integration, and OAuth support for email-based login.

Subscription Sharing

Pro plan subscriptions support multiple managers with shared access to all workspaces. Perfect for teams that need collaborative management of AI agents and resources, with unlimited managers on Pro plans.

Memory Retention Policies

Automatic memory management with subscription plan-based retention periods. Free plans retain 48 hours of working memory and 30 days of daily summaries, while Pro plans extend to 240 hours and 120 days respectively. Old memories are automatically cleaned up to optimize storage.

Streaming Support

Get real-time, streaming responses from your agents using Server-Sent Events (SSE) or Lambda Function URLs. Perfect for chat interfaces, interactive applications, and real-time user experiences. Responses stream token-by-token as they're generated, providing immediate feedback and a smooth conversational experience.

Webhook API

Every agent exposes a webhook endpoint that accepts HTTP requests. Send messages and receive AI-powered responses, making integration with your applications straightforward. Supports both synchronous responses and streaming via dedicated streaming endpoints.

Chat Platform Bot Integration

Deploy your agents as Slack or Discord bots, enabling team members and community users to interact with your AI agents directly in their favorite chat platforms. Create integrations that connect your agents to Slack workspaces or Discord servers, with full support for mentions, commands, and direct messages.

Slack Integration:

  • Deploy agents as Slack bots that respond to mentions and direct messages
  • Dynamic Slack App Manifest generation for easy setup
  • Secure webhook handling with signature verification
  • Throttled message updates for streaming-like experience
  • Support for both channel mentions and direct messages

Discord Integration:

  • Deploy agents as Discord bots with slash command support
  • Ed25519 signature verification for secure interactions
  • Throttled message updates for real-time responses
  • Full support for Discord's interaction system

Key Features:

  • Unified Management: Manage all integrations from a single Integrations page
  • Secure by Default: Platform-specific signature verification ensures only legitimate requests are processed
  • Easy Setup: Step-by-step guides for both platforms with manifest generation
  • Streaming Simulation: Throttled message updates provide near-real-time response experience
  • Full Agent Capabilities: Bots have access to all agent tools, memory, and knowledge bases

See Slack Integration and Discord Integration for detailed setup guides.

Notification Channels

Configure notification channels for your workspaces to enable agents to send messages to external platforms. Create Discord channels with bot tokens and channel IDs, or use Slack webhooks via the API. Agents can use the send_notification tool to deliver messages to configured channels, perfect for alerts, updates, and automated communications.

Team Collaboration

Workspace permissions allow you to control who can view, edit, or manage agents and documents. Perfect for teams that need granular access control.

Flexible Subscription Plans

Choose from Free, Starter, or Pro plans that scale with your needs. Each plan includes different limits for workspaces, agents, documents, and team members. View plans and pricing at helpmaton.com

Quick Start

Get started with Helpmaton in minutes:

  1. Sign up at helpmaton.com - Create your account and get instant access
  2. Create a Workspace - Set up your first workspace to organize your agents
  3. Add an Agent - Create an AI agent with a custom system prompt
  4. Upload Documents - Add knowledge base documents to inform your agent
  5. Test Your Agent - Use the webhook endpoint to send messages and receive responses

For detailed setup instructions, see the Getting Started Guide.

For Developers

Helpmaton is built with developers in mind. Integrate AI capabilities into your applications through our REST API and webhook endpoints. Access the platform at helpmaton.com and start building immediately.

Join our Discord community to discuss integrations, share code examples, and get developer support.

REST API

Full programmatic access to all platform features. Create workspaces, manage agents, upload documents, and configure permissions—all through our comprehensive API.

Webhook Endpoints

Each agent exposes a webhook URL that accepts POST requests. Send messages and receive AI responses in real-time. Perfect for chatbots, integrations, and automated workflows.

OpenAPI Documentation

Complete API documentation available in OpenAPI format. Generate client libraries, explore endpoints, and understand request/response schemas.

Integration Examples

  • Chat Platform Bots: Deploy agents as Slack or Discord bots for team collaboration and community engagement
  • Web Applications: Embed AI responses in web applications with real-time streaming
  • Automated Workflows: Build automated workflows that leverage AI capabilities
  • Research Assistants: Create research assistants that search the web for current information
  • News Monitoring: Deploy news monitoring agents that track industry developments
  • Content Analysis: Build content analysis tools that extract insights from web pages
  • Custom Interfaces: Create custom interfaces for agent interactions
  • MCP Extensions: Extend agents with MCP servers for database access, external APIs, and custom business logic

See the API Reference for complete endpoint documentation and MCP Servers for tool integration guide.

Contributing

We welcome contributions to Helpmaton! Whether you're fixing bugs, adding features, or improving documentation, your help makes Helpmaton better for everyone.

  • Contributing Guide - Learn how to contribute, including our CLA requirements and PR workflow
  • License - View the Business Source License 1.1 terms
  • Notice - Copyright and attribution information

Technology Stack

Helpmaton is built on modern, scalable infrastructure:

  • Backend: TypeScript, Node.js, AWS Lambda (including custom container images), API Gateway
  • Database: DynamoDB for high-performance data storage with atomic operations
  • Vector Database: LanceDB with S3 backend for agent memory and semantic search
  • Storage: S3 for document management and vector database persistence
  • Frontend: React with TypeScript
  • AI: Google Gemini API for embeddings and LLM capabilities
  • Queue Processing: SQS FIFO queues with message groups for serialized memory writes and partial batch failure support for efficient error handling
  • Deployment: Automated CI/CD with GitHub Actions, multi-stage Docker builds for optimization
  • Payments: Lemon Squeezy integration for subscriptions and credit purchases
  • Monitoring: Comprehensive usage tracking and analytics with automated aggregation

The platform is designed for reliability, scalability, and performance, handling everything from individual developers to enterprise teams.

Documentation

Getting Started

Architecture & Infrastructure

Core Features

Core Systems

Integrations

  • Slack Bot Integration - Deploy your agents as Slack bots for team collaboration
  • Discord Bot Integration - Deploy your agents as Discord bots for community engagement
  • MCP Servers - Configure and use MCP servers for external tools
  • Tavily Integration - Web search and content extraction with Tavily API
  • Discord Setup - Configure Discord notification channels for your agents
  • Email Setup - Configure email authentication and notifications
  • Notification Channels - Configure Discord and Slack webhook channels for agent notifications via the API

Reference

Development

Support

Getting Help

If you need assistance:

  1. Check the Troubleshooting Guide for common issues
  2. Review the API Reference for technical details
  3. Consult the relevant feature documentation for specific questions
  4. Join our Discord community - Get support, share your projects, and connect with other users

License

Helpmaton is licensed under the Business Source License 1.1. On November 1st, 2029, it will automatically be made available under the Apache License, Version 2.0.

  • LICENSE - Full license terms and conditions
  • NOTICE - Copyright notice and attribution requirements

For more information about contributing, see our Contributing Guide.


Ready to get started? Sign up at helpmaton.com to create your first workspace and deploy your first AI agent. No credit card required for the free plan.

For detailed instructions, check out the Getting Started Guide.

Need help or want to connect? Join our Discord community to get support, share your projects, and connect with other Helpmaton users.

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •