Synapsara

provenance:github:smouj/Synapsara

WHAT THIS AGENT DOES

Synapsara helps you find answers by searching across all your different documents, notes, and files. It addresses the common problem of information being scattered and hard to connect. This tool is ideal for anyone who needs to quickly understand a large amount of information, like researchers, analysts, or anyone managing a lot of documents. Synapsara provides answers with clear references to where the information came from, ensuring you can verify its accuracy. It’s particularly useful for combining information from multiple sources to form a complete picture.

View Source ↗First seen 1mo agoNot yet hireable

README

# Synapsara

<p align="center">
  <img src="./assets/branding/logo.svg" alt="Synapsara logo" width="88" />
</p>

![Language](https://img.shields.io/badge/language-Python%203.11%2B-blue)
![License](https://img.shields.io/github/license/smouj/Synapsara)
![Last Commit](https://img.shields.io/github/last-commit/smouj/Synapsara)
![CI](https://img.shields.io/github/actions/workflow/status/smouj/Synapsara/ci.yml?branch=main)
[![Ko-fi](https://img.shields.io/badge/Ko--fi-Support%20this%20project-ff5f5f?logo=ko-fi&logoColor=white)](https://ko-fi.com/smouj013_dev)

<p align="center">
  <a href="./README.md"><img src="https://img.shields.io/badge/README-English-1f6feb?style=for-the-badge" alt="English"></a>
  <a href="./README.es.md"><img src="https://img.shields.io/badge/README-Español-c92a2a?style=for-the-badge" alt="Español"></a>
</p>

**Multi-source RAG intelligence with grounded local retrieval.**

## Vision
Indexes heterogeneous local sources and returns citation-backed semantic answers.

## What problem it solves
Knowledge is fragmented across documents, notes, and archives.

## Core superpower
- ⚡ **Hybrid retrieval with source attribution and contextual query understanding**

## Key use cases
- ✅ Personal knowledge search
- ✅ Document Q&A
- ✅ Cross-source synthesis
- ✅ Evidence-first responses


## API surface
`POST /query`, `GET /health`

## Technical stack
- **Core stack:** FastAPI + ChromaDB + sentence-transformers
- **Runtime:** local-first, self-hosted friendly
- **Infra:** Docker Compose + Caddy + Redis/Chroma/Ollama compatibility

## Current status (Feb 2026)
- ✅ Public scaffold available
- ✅ Bilingual README (EN default + ES)
- ✅ CI + release baseline configured
- 🚧 Feature hardening in progress

## Quick start
```bash
git clone https://github.com/smouj/Synapsara.git
cd Synapsara
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python -m src.synapsara.cli --help
```

## Documentation
- [Implementation Guide](./docs/IMPLEMENTATION.md)
- [Architecture](./docs/ARCHITECTURE.md)
- [Runbook](./docs/RUNBOOK.md)
- [Deployment Guide](./docs/DEPLOYMENT.md)
- [Release Process](./docs/RELEASE.md)
- [Changelog](./CHANGELOG.md)

## Contributing
Contributions are welcome. Please read [CONTRIBUTING.md](./CONTRIBUTING.md).

## License
MIT © 2026 smouj

---

### Other skills
Explore the full ecosystem here: **[smouj/smouj](https://github.com/smouj/smouj)**

**Signature:** [@Smouj013](https://x.com/smouj013)

PUBLIC HISTORY

First discoveredMar 21, 2026

IDENTITY

inferred

Identity inferred from code signals. No PROVENANCE.yml found.

Is this yours? Claim it →

METADATA

platformgithub

first seenFeb 23, 2026

last updatedFeb 24, 2026

last crawled13 days ago

version—

README BADGE

Add to your README:

![Provenance](https://getprovenance.dev/api/badge?id=provenance:github:smouj/Synapsara)