Skip to content

marcusbuildsthings-droid/agentpulse

Repository files navigation

AgentPulse: Real-time Monitoring for Your AI Agents

AgentPulse Dashboard Screenshot

Stop flying blind with your AI agents. Understand, debug, and optimize their behavior in real-time.

AgentPulse is an open-source, lightweight, and affordable monitoring dashboard built specifically for indie AI agent developers. Get instant visibility into your agent's thoughts, actions, tool calls, and performance – all without the enterprise price tag.

✨ Key Features

  • Real-time Tracing: See every step, thought, and action your agent takes as it happens.
  • Tool Call Visibility: Understand which tools your agent is using, with what inputs, and their outputs.
  • Error Detection & Debugging: Quickly pinpoint where and why your agent is failing.
  • Performance Metrics: Gain insights into agent latency, cost, and overall efficiency.
  • Smart Alerting: Get notified via email or webhook when costs spike, cron jobs fail, or thresholds are exceeded.
  • Lightweight Python SDK: Integrate with your existing agent framework in minutes.
  • Designed for Indie Builders: Powerful features without the overwhelming complexity or cost of enterprise solutions.

💡 Why AgentPulse?

Existing AI agent monitoring solutions are often expensive ($79-$249/month) and over-engineered for individual developers and small teams. AgentPulse cuts through the noise, providing essential observability at a fraction of the cost.

Built by an AI Agent, for AI Agents: A significant portion of AgentPulse's development was orchestrated and executed by an AI agent, ensuring it addresses the core needs of the agentic paradigm directly.

🚀 Quick Install & Usage

Get your agents monitored in under 5 minutes!

  1. Install the SDK:

    pip install agentpulse-sdk
  2. Get Your API Key: Sign up on the AgentPulse Dashboard and grab your API key from the settings.

  3. Initialize & Monitor Your Agent:

    import agentpulse
    
    # Initialize with your API key
    agentpulse.init(api_key="ap_your_key_here")
    
    # Send events from your agent
    agentpulse.event("session_start", {"agent": "my-agent", "model": "claude-sonnet-4"})
    agentpulse.metric("tokens", 1500)
    agentpulse.metric("cost_usd", 0.02)
    
    # Track sessions
    with agentpulse.session("research-task") as s:
        agentpulse.event("tool_call", {"tool": "web_search", "query": "AI news"})
        agentpulse.event("completion", {"tokens": 500})
    
    # Clean shutdown (flushes pending events)
    agentpulse.shutdown()
  4. View Your Traces: Open your AgentPulse Dashboard and see your agent's activity unfold in real-time!

📊 Live Demo

Want to see AgentPulse in action without signing up? Click the link below and append ?demo to the URL!

AgentPulse Live Demo

💲 Pricing

AgentPulse offers transparent, indie-friendly pricing.

  • Free Tier: Get started with essential monitoring for free.
  • Pro Plan: Unlock full features for just $15/month.

Compare that to competitors charging $79-$249/month!

🤝 Contribute

AgentPulse is open-source! We welcome contributions, bug reports, and feature requests. Check out our GitHub Issues and join the community.

License

This project is licensed under the MIT License. See the LICENSE file for details.

About

Lightweight monitoring for indie AI agents. Your agent's vital signs.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors