{"id":48633094,"url":"https://github.com/usemoss/pipecat-moss","last_synced_at":"2026-04-09T06:03:40.290Z","repository":{"id":325005585,"uuid":"1099387208","full_name":"usemoss/pipecat-moss","owner":"usemoss","description":null,"archived":false,"fork":false,"pushed_at":"2026-01-19T04:53:36.000Z","size":1099,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-19T13:37:55.862Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/usemoss.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-18T23:41:14.000Z","updated_at":"2026-01-19T04:53:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/usemoss/pipecat-moss","commit_stats":null,"previous_names":["yatharthk2/pipecat-moss","usemoss/pipecat-moss"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/usemoss/pipecat-moss","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usemoss%2Fpipecat-moss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usemoss%2Fpipecat-moss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usemoss%2Fpipecat-moss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usemoss%2Fpipecat-moss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/usemoss","download_url":"https://codeload.github.com/usemoss/pipecat-moss/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usemoss%2Fpipecat-moss/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31588040,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-09T05:33:47.836Z","status":"ssl_error","status_checked_at":"2026-04-09T05:32:26.579Z","response_time":112,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-04-09T06:03:36.230Z","updated_at":"2026-04-09T06:03:40.285Z","avatar_url":"https://github.com/usemoss.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pipecat Moss Integration\n\nMoss delivers sub-10ms semantic retrieval, ensuring your Pipecat AI voice agents respond naturally without noticeable delays.\n\n## Installation\n\nInstall the package\n\n```bash\npip install pipecat-moss\n```\n\n## Prerequisites\n- Moss project ID and project key (get them from [Moss Portal](https://portal.usemoss.dev))\n- Deepgram, OpenAI, Cartesia API keys (to run the example)\n\n## Usage with Pipecat Pipeline\n\nPipecat-Moss integrates seamlessly into a Pipecat pipeline, enabling efficient retrieval-based operations. It leverages Pipecat's modular architecture to inject semantic context for Voice AI Agents.\n\n```python\nimport os\nimport asyncio\nfrom pipecat_moss import MossRetrievalService\n\nmoss_service = MossRetrievalService(\n    project_id=os.getenv(\"MOSS_PROJECT_ID\"),\n    project_key=os.getenv(\"MOSS_PROJECT_KEY\"),\n    system_prompt=\"Relevant passages from the Moss knowledge base:\\n\\n\",\n)\n\nasync def setup_indexes():\n    await moss_service.load_index(os.getenv(\"MOSS_INDEX_NAME\"))\n\nasyncio.run(setup_indexes())\n\npipeline = Pipeline([\n    transport.input(),               # audio/user input\n    stt,                             # speech to text\n    context_aggregator.user(),       # add user text to context\n    moss_service.query(os.getenv(\"MOSS_INDEX_NAME\"), top_k=5, alpha=0.8),  # retrieve relevant docs from Moss\n    llm,                             # LLM generates response\n    tts,                             # TTS synthesis\n    transport.output(),              # stream audio back to user\n    context_aggregator.assistant(),  # store assistant response\n])\n```\n\n`setup_indexes()` must be awaited before the pipeline starts so the service can load the Moss index. See `examples/moss-retrieval-demo.py` for a complete working example.\n\n## Pipecat Compatibility\n\nTested with Pipecat v0.0.99. Please upgrade to this version (or newer) to ensure API compatibility with the snippets below.\n\n## Contributing \n\nIf you are contributing or want to build from source, follow the [CONTRIBUTING.md](CONTRIBUTING.md) setup steps.\n\n## Running the Example\n\n### Setup Environment Variables\n\nCreate a `.env` file in the root directory with the following content:\n\n```env\nMOSS_PROJECT_ID= Your Moss Project ID\nMOSS_PROJECT_KEY= Your Moss Project Key\nMOSS_INDEX_NAME= Your Moss Index Name\n\nDEEPGRAM_API_KEY= Your DEEPGRAM API KEY\nCARTESIA_API_KEY= Your CARTESIA API KEY\nOPENAI_API_KEY= Your OpenAI Key\n```\n\nOr pass them directly when creating the MossRetrievalService.\n\n### Creating a Moss Index (One-time Setup)\n\nBefore using Moss in your pipeline, you need to create an index and populate it with documents:\n\n```bash\npython examples/moss-create-index-demo.py\n```\n\n### Run the Example\n\n```bash\npython examples/moss-retrieval-demo.py\n```\n\n## Configuration Options\n\n### MossRetrievalService\n\n- `project_id` (required): Moss project ID (can use env var `MOSS_PROJECT_ID`)\n- `project_key` (required): Moss project key (can use env var `MOSS_PROJECT_KEY`)\n- `system_prompt` (default: \"Here is additional context retrieved from database:\\n\\n\"): Prefix added ahead of retrieved documents\n- `load_index(index_name)`: Awaitable method that loads the given index before the pipeline runs\n- `query(index_name, *, top_k=5)`: Returns a `MossIndexProcessor` for the specified index; `top_k` controls result count, `alpha` blends semantic vs keyword scoring (0.0 keyword-only, 1.0 semantic-only)\n\n## License\n\nThis integration is provided under a permissive open source license (BSD-2 or equivalent).\n\n## Support\n\n- [Moss Docs](https://docs.usemoss.dev)\n- [Moss Discord](https://discord.com/invite/eMXExuafBR)\n- [Pipecat Docs](https://docs.pipecat.ai)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fusemoss%2Fpipecat-moss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fusemoss%2Fpipecat-moss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fusemoss%2Fpipecat-moss/lists"}