Skip to content

fixadev/fixa-observe

Repository files navigation

Fixa Logo

fixa: open-source testing and observability for voice agents

fixa helps you run simulated tests, analyze production calls, fix bugs in your voice agents. oh, and we're fully open source.

get started for free with our cloud platform - no demos, no commitments, only pay for what you use.

Fixa Dashboard

✨ Features

Automated Testing
Our voice agents call your voice agents to catch issues before they reach production
Recording
Deploy with Peace of Mind
Integrate seamlessly into your CI/CD pipeline using our prebuilt github action, API, or SDK
Recording
Monitor Production Calls
Analyze latency, interruptions, and custom evals
Test Suites
Measure What Matters
Create evaluations to validate specific conversation flows and edge cases
Alerts
Catch Issues Instantly
Slack alerts notify you immediately if evaluations fail in production or latency thresholds are exceeded
alerts

📦 Installation & Setup

  1. Create an account at fixa.dev

  2. Install the Fixa SDK:

    npm install @fixa-dev/server
    # or
    yarn add @fixa-dev/server
  3. Configure and use the client:

    import { FixaClient } from "@fixa-dev/server";
    
    const client = new FixaClient({ token: "YOUR_TOKEN" });
    
    await client.agent.create({
      phoneNumber: "phoneNumber",
      name: "name",
      systemPrompt: "systemPrompt",
    });
  4. Use TypeScript types:

    import { Fixa } from "@fixa-dev/server";
    
    const request: Fixa.AgentCreateRequest = {
      // your request object
    };
  5. Handle errors:

    import { FixaError } from "@fixa-dev/server";
    
    try {
      await client.agent.create({...});
    } catch (err) {
      if (err instanceof FixaError) {
        console.log(err.statusCode);
        console.log(err.message);
        console.log(err.body);
      }
    }

For detailed setup instructions and examples, visit our documentation.