README
¶
vowifi-go
An independent, open Go implementation of the VoHive VoWiFi runtime boundary.
This repository focuses on the public runtime APIs and protocol layers that VoHive consumes for SIM/ISIM AKA, SWu/ePDG tunneling, IMS registration, messaging, voice bridging, and userspace dataplane experiments.
Status
vowifi-go is still under active development. It is not affiliated with, endorsed by, or a drop-in replacement for any vendor, operator, or official closed-source VoWiFi implementation.
The project does not yet implement the complete feature set of the official closed-source implementation. Full SIP transaction timer state machines, advanced IMS feature interworking, carrier-specific behavior, production hardening, and real-world compatibility work are still being implemented incrementally behind the current APIs.
Quick Start
Run the test suite:
go test ./...
Run the same local CI entry point used by GitHub Actions:
make ci
When integrating with VoHive, prefer a tagged release or pseudo-version in the
consumer go.mod:
go get github.com/boa-z/vowifi-go@latest
For local compatibility work, use make compat-vohive; it creates a temporary
VoHive copy and adds the local replace only inside that throwaway checkout.
Documentation
- Features - current implementation inventory and known gaps.
- VoHive readiness - remaining work before this module should be treated as usable inside VoHive.
- Architecture - package layout, runtime boundaries, and high-level flow.
- Development - CI targets, local validation, and workspace usage.
- Disclaimer - legal, compliance, warranty, and operational-risk notice.
- Chinese README and Chinese disclaimer.
Disclaimer Summary
vowifi-go is provided for personal learning, technical research, and functional testing. Users are responsible for complying with local laws, telecom operator terms, device requirements, and network policies. The software is provided "as is", without warranties, and the authors and contributors are not liable for losses caused by use, misuse, deployment, or inability to use this project.
Read the full Disclaimer before using the project.
Directories