Skip to main content

callscope-ai

Python library (imported as callscope) to analyze customer-service calls locally: timestamped transcript, who speaks when, sentiment curve, contact reasons and key moments, in one JSON.

Install

pip install callscope-ai              # analysis of transcripts (no dependencies)
pip install "callscope-ai[whisper]"   # + local transcription of audio (faster-whisper)

Use

import callscope

result = callscope.analyze("call.wav")                 # audio -> full analysis
result = callscope.analyze([{"start": 0, "end": 3, "text": "Bonjour, comment puis-je vous aider ?"}])
callscope demo                      # fictional call, no audio, no model
callscope analyze call.wav --model small
callscope analyze segments.json

French and English keyword lexicons are built in; everything runs on your machine.

Functions

Function Returns
transcribe(path, model_size, language) [{start, end, text}] (needs the whisper extra)
diarize(segments, channel_roles=None) segments with speaker = agent or customer (stereo channels, else turn-taking heuristic)
sentiment(segments) per-segment score (-1..1), customer curve, mean and trend
contact_reasons(segments) ranked reasons: billing, cancellation, outage, delivery, technical_support, subscription_change
key_moments(segments) complaints, churn threats, agent promises
analyze(source) everything above in one dict

Output format (callscope/1)

analyze() returns {schema, source, duration, segments, sentiment, contact_reasons, key_moments}. This is the shared format for tools built on callscope.

Limits

  • French and English only: sentiment, contact reasons and key moments come from small keyword lists (lexicon.py), whole-word matching.
  • Speaker separation (agent or customer) is a heuristic: stereo channels if given, else turn-taking on silences and greeting phrases.
  • Simple, inspectable baselines to sort calls for human review, not state-of-the-art models.

To use it from Claude, see the MCP server custovox-calls.

MIT licensed. Run tests with pip install -e ".[test]" && pytest (no network).

About

Built by CustoVox.ai. This free tool runs on your machine. The hosted platform at custovox.ai covers 5 languages, voice, text and images, with reports and integrations. From $89/month.

Metadata

Release files for callscope-ai 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for callscope-ai 0.1.1
File Size Uploaded Provenance Actions
callscope_ai-0.1.1.tar.gz 9.9 kB Without provenance Details for callscope_ai-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for callscope-ai 0.1.1
File Interpreter ABI Platform Actions
callscope_ai-0.1.1-py3-none-any.whl Python 3 none any Details for callscope_ai-0.1.1-py3-none-any.whl

Total release size: 19.3 kB

Release files / callscope_ai-0.1.1.tar.gz

Download URL callscope_ai-0.1.1.tar.gz
Size 9.9 kB
Tags Source
SHA-256 checksum
How to use checksums
fe1b86065bbef6f52bffd143ab85c3239edaadf9acdac82acd80ac33100679d2
BLAKE2b-256 checksum
How to use checksums
060f8eb6ce9ce39c55f7c95d4532c1e131b58e3699c964b4b8b0e5e481766c86
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Release files / callscope_ai-0.1.1-py3-none-any.whl

Download URL callscope_ai-0.1.1-py3-none-any.whl
Size 9.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fdba9ecf47534d4ec79513ff3659d537c261da0079727c1682522db6ecd21533
BLAKE2b-256 checksum
How to use checksums
a0beff2380b0195574eb4a5d171cc7ac2401627e228fc3a71845bfc18978fbcc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.10

Security for callscope-ai 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page