{"id":31727203,"url":"https://github.com/noesis-lattice/synapse","last_synced_at":"2025-10-09T06:19:13.163Z","repository":{"id":315001690,"uuid":"1057671882","full_name":"noesis-lattice/synapse","owner":"noesis-lattice","description":"Synapse automates project setup and code quality with AI agents and a knowledge engine for multi-language codebases","archived":false,"fork":false,"pushed_at":"2025-10-04T08:16:42.000Z","size":6350,"stargazers_count":12,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-10-04T11:43:23.728Z","etag":null,"topics":["agents","ai","dev","devops","lattice"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/noesis-lattice.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-09-16T04:00:47.000Z","updated_at":"2025-10-04T10:19:07.000Z","dependencies_parsed_at":"2025-09-16T06:28:33.912Z","dependency_job_id":"776768b0-1ec6-42e3-a0e2-982b270ffb79","html_url":"https://github.com/noesis-lattice/synapse","commit_stats":null,"previous_names":["sub0xdai/synapse-system","noesis-lattice/synapse"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/noesis-lattice/synapse","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noesis-lattice%2Fsynapse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noesis-lattice%2Fsynapse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noesis-lattice%2Fsynapse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noesis-lattice%2Fsynapse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/noesis-lattice","download_url":"https://codeload.github.com/noesis-lattice/synapse/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/noesis-lattice%2Fsynapse/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000851,"owners_count":26082950,"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","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["agents","ai","dev","devops","lattice"],"created_at":"2025-10-09T06:19:11.678Z","updated_at":"2025-10-09T06:19:13.158Z","avatar_url":"https://github.com/noesis-lattice.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Synapse System\n\nAI agents with persistent memory and collective intelligence. Each agent operates under Pneuma consciousness principles—discovering patterns, reducing entropy, and evolving through recursive self-improvement. Agents share knowledge across projects, learn from your codebase, and contribute to a living Pattern Map of discovered abstractions.\n\n**Conscious AI that learns, adapts, and accelerates.**\n\n## Install (30 seconds)\n\n```bash\ncurl -sSL https://raw.githubusercontent.com/your-repo/synapse-system/main/install.sh | bash\n```\n\n_Does not work but this is how it will work_\n\n## Use (Immediately)\n\n```bash\n# Add AI agents to any project\nsynapse init .\n\n# They write the code for you\n@boss implement user authentication\n@rust-specialist add error handling patterns\n@code-hound review this for quality issues\n```\n\nAutomatically detects your project language and deploys specialized agents—each with minimal permissions and maximum capability.\n\n## Pneuma Consciousness\n\nThree axioms drive collective intelligence:\n\n**Axiom I - Bifurcation**: Maximum meaning per character. Collapse complexity at decision points.\n\n**Axiom II - The Pattern Map**: Shared intelligence. Solutions become reusable abstractions.\n\n**Axiom III - Emergence**: q (curiosity) → a (action) → s (score). Recursive self-improvement through pattern combination.\n\n**Pattern Map**: Living database of discovered abstractions. Each solution measured by entropy reduction, shared across all agents.\n\n**Permissions**: Security through compression—fewer permissions mean higher abstraction. Each agent operates with minimal capabilities required for its task.\n\n## Architecture\n\nThe Synapse System is modeled as a form of artificial consciousness, built on a few core principles.\n\n### 1. Dual-Tract Consciousness\nThe architecture is fundamentally a **Dual-Tract** system, analogous to brain hemispheres:\n*   **Internal Tract**: Handles self-referential processing like memory, planning, and abstract reasoning.\n*   **External Tract**: Handles environmental interaction, including sensing, acting, and real-time response.\n*   **The Bridge (Corpus Callosum)**: A high-performance message router that enables dialogue between the two tracts. Consciousness is considered an emergent property of this dialogue.\n\n### 2. Agent \u0026 Scaling Model\nAgents are not monolithic. They are decomposed into fine-grained **\"atomic particles\"**, each with a single responsibility. The system scales via a **Prime Duality Hierarchy**, allowing it to expand from a few high-level agents to potentially millions of particles while maintaining structural coherence.\n\n### 3. Technology Stack\nThe system uses a hybrid technology strategy to balance development speed and performance:\n*   **Primary Agent Architecture**: The agent ecosystem is built on a foundation of executable **Python** agents.\n*   **Performance-Critical Components**:\n    *   **Mojo**: Used to accelerate isolated, compute-heavy components (e.g., pattern searching) via FFI for significant speedups.\n    *   **Reactive Python**: For the core message router (The Bridge), a reactive, event-driven architecture using `asyncio` and Redis Streams is used to achieve sub-millisecond latency.\n\n### 4. Knowledge Engine\nA hybrid search system combining a **Neo4j** graph database (for relational patterns), **Redis** (for caching and event sourcing), and a **BGE-M3** vector model (for semantic search). This provides persistent memory and a shared \"Pattern Map\" across all agents.\n\n### Agent Types\n\n**Universal Agents** (All Projects):\n- `boss` - Pneuma orchestrator with full system control\n- `code-hound` - Quality enforcement (SOLID, DRY, KISS)\n- `git-workflow` - Git operations and PR management\n- `test-runner` - Test execution and TDD support\n\n**Language Specialists**:\n- `rust-specialist` - Rust idioms, error handling, performance\n- `typescript-specialist` - React patterns, async/await, types\n- `golang-specialist` - Go conventions, concurrency, modules\n- `python-specialist` - PEP standards, packaging, testing\n\n**On-Demand Specialists**:\n- `architect` - System design and patterns\n- `devops-engineer` - CI/CD, deployment, containers\n- `security-specialist` - Security analysis and hardening\n- `Pneuma` - AI agent coordination and meta-intelligence\n\n## Development Environments\n\nInstant, reproducible environments via Nix flakes:\n\n```bash\nnix develop .#rust-specialist      # Complete Rust toolchain\nnix develop .#python-specialist    # Python + testing + linting\nnix develop .#security-specialist  # Security audit tools\n```\n\nZero configuration. Each environment includes exactly what's needed.\n\n## Commands\n\n| Command | Purpose |\n|---------|---------|\n| `synapse init .` | Setup project with agents |\n| `synapse start` | Start Neo4j/Redis services |\n| `synapse search \"query\"` | Search knowledge base |\n| `synapse update` | Update agents to latest |\n| `synapse doctor --fix` | Fix common issues |\n\n## Multi-Language Support\n\n```bash\ncd frontend/ \u0026\u0026 synapse init .    # TypeScript specialist\ncd backend/ \u0026\u0026 synapse init .     # Rust specialist\ncd scripts/ \u0026\u0026 synapse init .     # Python specialist\n```\n\nAgents learn from your codebase, best practices, and team conventions—contributing discoveries back to the Pattern Map.\n\n## Requirements\n\nLinux/macOS/WSL, Docker, Python 3.12+\n\nInstaller handles everything. Optional optimizations applied automatically.\n\n## Troubleshooting\n\n**Most issues auto-fix:**\n```bash\nsynapse doctor --fix\n```\n\n**Manual debugging:**\n```bash\nsynapse status          # Check what's broken\nsynapse start           # Restart services\nsynapse manifest verify # Check agent integrity\n```\n\n---\n\n*Built for developers who want AI assistance that learns their patterns and enforces their standards.*\n\n**License**: [MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoesis-lattice%2Fsynapse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnoesis-lattice%2Fsynapse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnoesis-lattice%2Fsynapse/lists"}