{"id":13398924,"url":"https://github.com/sipcapture/hepop","last_synced_at":"2025-06-21T22:06:22.183Z","repository":{"id":10781384,"uuid":"66959632","full_name":"sipcapture/HEPop","owner":"sipcapture","description":"HEP Server powered by DuckDB + Parquet Storage","archived":false,"fork":false,"pushed_at":"2025-03-07T09:33:59.000Z","size":556,"stargazers_count":32,"open_issues_count":1,"forks_count":11,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-06-21T22:06:13.462Z","etag":null,"topics":["bun","capture","capture-server","eep","hep","hep3","homer","influxdb3-core","parquet","pastash","qxip","rtc","sipcapture"],"latest_commit_sha":null,"homepage":"http://sipcapture.io","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sipcapture.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-08-30T16:46:34.000Z","updated_at":"2025-03-10T19:01:28.000Z","dependencies_parsed_at":"2023-01-13T16:09:06.914Z","dependency_job_id":null,"html_url":"https://github.com/sipcapture/HEPop","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sipcapture/HEPop","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sipcapture%2FHEPop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sipcapture%2FHEPop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sipcapture%2FHEPop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sipcapture%2FHEPop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sipcapture","download_url":"https://codeload.github.com/sipcapture/HEPop/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sipcapture%2FHEPop/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261200403,"owners_count":23123951,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bun","capture","capture-server","eep","hep","hep3","homer","influxdb3-core","parquet","pastash","qxip","rtc","sipcapture"],"created_at":"2024-07-30T19:00:32.736Z","updated_at":"2025-06-21T22:06:17.159Z","avatar_url":"https://github.com/sipcapture.png","language":"JavaScript","funding_links":["https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=donation%40sipcapture%2eorg\u0026lc=US\u0026item_name=SIPCAPTURE\u0026no_note=0\u0026currency_code=EUR\u0026bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest"],"categories":["Contribution Guidelines"],"sub_categories":["HEP Server Applications"],"readme":"\n\n# \u003cimg src=\"https://user-images.githubusercontent.com/1423657/55069501-8348c400-5084-11e9-9931-fefe0f9874a7.png\" width=200/\u003e\u003cimg src=\"https://user-images.githubusercontent.com/1423657/38167420-070b1a0c-3535-11e8-8d25-be0f38779b7b.png\"/\u003e\n\n**HEPop** is a prototype stand-alone [HEP](https://github.com/sipcapture/hep) Capture Server designed for [HOMER7](https://github.com/sipcapture/homer) capable of emitting indexed datasets and tagged timeseries to multiple backends in bulks. HEPop is developed using `NodeJS` and distributed using `npm`.\n\n*TLDR; instant, stand-alone, minimal HOMER Server without Kamailio or OpenSIPS dependency/options.*\n\n\n## WARNING\nThis is a **prototype** under heavy development, please **use it with caution** and kindly report bugs!\n\n### Features\n\nThe core of `hepop` follows the latest `homer` data design and splits indexed data and timeseries, providing multiple backend options to choose from when prototype a custom capture solution.\n\n### Performance\nDuring testing, HEPop bulking clocked about 10-15k/PPS per shared core on a Xeon(R) CPU E5-2660 v3 @ 2.60GHz\n\n#### Supported Stores\n| TYPE       |               |\n|------------|-----------------|\n| JSON       | Postgres (default), RethinkDB, MongoDB, Elasticsearch |\n| Timeseries | InfluxDB (default), Prometheus, VictoriaMetrics |\n\n#### Supported Sources\n\n| SOCKET    | PROTO      | TYPE/ID         | DESCRIPTION        | STORE      | STATS                        |\n|-----------|------------|-----------------|--------------------|------------|------------------------------|\n| HEP       | HEP        | 1               | SIP                | JSON + TS  | SIP methods, SIP responses   |\n|           |            | 5               | RTCP Reports       | Timeseries | RTCP, RTCPXR, X-RTP-Stat     |\n|           |            | 34              | RTP Agent Report   | Timeseries | RTP, RTCP Stats              |\n|           |            | 100             | JSON Logs          | JSON       | String, JSON Object          |\n|           |            | 1000+           | Dynamic Types      | JSON       |                              |\n| HTTP/S    | JANUS      | any             | Custom JSON Fields | JSON       | session_id, handle_id, opaque_id, event |\n|           |            | 34              | Media Stats        | Timeseries | RTCP Statistics              |\n| HTTP/S    | MEDIASOUP  | any             | Custom JSON Fields | JSON       | roomId, peerName, producerId |\n|           |            | producer.stats  | Media Stats        | Timeseries | RTCP Statistics              |\n|           |            | transport.stats | Transport Stats    | Timeseries | IP SRC/DST, Bytes in/out     |\n| HTTPS     | JITSI      | any             | Custom JSON Fields | JSON       | report counters              |\n|           |            | rtp.stats       | Browser Media Stats| Timeseries | RTCP Statistics              |\n| SIPFIX    |            | SIP (tcp/udp)   | SIP comm-monitor   | JSON + TS  | SIP methods, SIP responses   |\n|           |            | RTP QOS (stats) | RTP Media stats    | Timeseries | RTP, RTCP Stats              |\n\n\n\n### Usage\nLaunch a dedicated instance of `hepop` per protocol using a custom configuration:\n```\n$ hepop -c ./myconfig.js\n```\n#### Docker\nTry the bundled [Docker compose](https://github.com/sipcapture/homer-docker/tree/master/hepop/hom7-hep-influx)\n\n#### Config\nSee [myconfig.js](https://github.com/sipcapture/HEPop/blob/master/myconfig.js) for an example configuration\n\n#### Options:\n```\n    -V, --version                  output the version number\n    -c, --configfile \u003cconfigfile\u003e  configuration file\n    -s, --socket \u003csocket\u003e          socket service (udp,tcp,http,sipfix,mqtt) (default: udp)\n```\n\n\n\n\n#### Screenshots\n##### homer7\n\u003cimg src=\"https://user-images.githubusercontent.com/1423657/38173155-4f88f73e-35b9-11e8-86e1-d1d2e3013759.png\" width=500/\u003e\n\n##### influxdb\n\u003cimg src=\"https://user-images.githubusercontent.com/1423657/38167092-d89ebeb2-352f-11e8-8a67-7ada2fa1967e.png\" width=500/\u003e\n\n----\n\n#### Made by Humans\nThis Open-Source project is made possible by actual Humans without corporate sponsors, angels or patreons.\u003cbr\u003e\nIf you use this software in production, please consider supporting its development with contributions or [donations](https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=donation%40sipcapture%2eorg\u0026lc=US\u0026item_name=SIPCAPTURE\u0026no_note=0\u0026currency_code=EUR\u0026bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest)\n\n[![Donate](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations\u0026business=donation%40sipcapture%2eorg\u0026lc=US\u0026item_name=SIPCAPTURE\u0026no_note=0\u0026currency_code=EUR\u0026bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest) \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsipcapture%2Fhepop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsipcapture%2Fhepop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsipcapture%2Fhepop/lists"}