simple-sip-client 0.0.3

Pure-Python SIP VoIP client library

simple-sip-client

Pure-Python SIP VoIP client library (no external dependencies for SIP/RTP). Can be used ala CLI Tool or Code Library.

Full documentation: docs/index.md

Installation

# from PyPI
pip install simple-sip-client

# or from source (editable)
pip install -e .

Then use from any script:

from simple_sip import SIPClient

Or run demos directly:

python demos/basic.py
python demos/tts-stt.py

Project Structure

voip/
├── README.md
├── setup.py
├── pyproject.toml
├── hold-queue-config.json
├── hold-queue.py        # Music-on-hold with announcements
├── main.py              # CLI-based SIP client
├── demos/
│   ├── basic.py         # Interactive SIP client demo
│   ├── queue.py         # Simple audio streaming demo
│   ├── debug-audio.py   # RTP audio dump tool
│   └── tts-stt.py       # Voice chat with local STT/TTS
└── src/
    └── simple_sip/      # Python package
        ├── __init__.py
        ├── sip_client.py   # SIP client (register, call, events)
        ├── sip_message.py  # SIP message parser/generator
        ├── sip_auth.py     # Digest authentication
        ├── sip_transport.py # UDP transport
        ├── sip_sdp.py      # SDP parser/answer/offer
        ├── sip_media.py    # RTP media stream
        └── ringtone.py     # Ringtone player

Demos

• basic.py – Interactive SIP client (receive/make calls)
• hold-queue.py – Auto-answer with music-on-hold + announcements
• queue.py – Stream audio file as RTP to caller
• debug-audio.py – Save incoming RTP audio to WAV files
• tts-stt.py – Voice chat with local STT/TTS
• main.py – CLI with --on-invite scripts

Configuration

Edit hold-queue-config.json for hold-queue.py settings. Environment variables SIP_SERVER, SIP_PORT, SIP_USER, SIP_PASS override defaults in demo scripts.

License

MIT