Partnerships OS

Enterprise partnership intelligence powered by knowledge graphs, voice AI, and automated research.

Getting Started · Architecture · Features · Contributing

Partnerships OS is a three-tier intelligence platform that transforms contacts and partnerships into a richly researched, deeply connected knowledge graph. It combines a Neo4j graph database for relationship mapping, a voice-first AI agent for hands-free data capture, and a Notion-synced CRM — enabling teams to build, track, and leverage their collective network with unprecedented depth.

• Knowledge Graph Engine — Neo4j-powered relationship mapping with typed edges capturing strength, context, and history across contacts, organizations, and interactions
• Voice-First AI Agent — Mobile voice interface (Deepgram STT + ElevenLabs TTS + Claude reasoning) supporting contact intake, network queries, interaction logging, and outreach recommendations
• Automated Research Pipeline — BullMQ background jobs that enrich contacts via Tavily web research, Claude-powered synthesis, pgvector embeddings, and Neo4j graph inference
• Interactive Graph Visualization — D3.js force-directed network explorer with filters, community detection, and path-finding between any two nodes
• Notion Bi-Directional Sync — Real-time mirroring of contacts, interactions, and pipeline state to structured Notion databases with per-member views
• RAG-Powered Search — Hybrid semantic search combining pgvector embeddings, Neo4j graph traversal, and full-text search with Claude-generated natural language answers
• AI Discovery Engine — Event planning, gap analysis, and warm intro pathfinding powered by graph analysis and LLM reasoning

graph TD
    subgraph "Mobile · Expo SDK 52"
        M1[Voice Agent] --> M2[Contact Intake]
        M1 --> M3[Network Query]
        M1 --> M4[Interaction Logging]
    end

    subgraph "Web Dashboard · Next.js 15"
        W1[D3.js Graph Explorer] --> W2[Contact Profiles]
        W3[Pipeline Views] --> W4[Analytics]
        W5[Admin Console]
    end

    subgraph "API · Fastify 5"
        A1[Auth · Google OAuth + JWT]
        A2[Contact CRUD]
        A3[Research Pipeline]
        A4[Graph Intelligence]
        A5[Voice Agent Handler]
        A6[Notion Sync Engine]
    end

    subgraph "Data Layer"
        D1[(PostgreSQL + pgvector)]
        D2[(Neo4j Knowledge Graph)]
        D3[(Redis + BullMQ)]
    end

    subgraph "External Services"
        E1[Claude API]
        E2[Notion API]
        E3[Tavily Research]
        E4[Deepgram STT]
        E5[ElevenLabs TTS]
    end

    M1 & M2 & M3 & M4 --> A5
    W1 & W2 & W3 & W4 & W5 --> A2 & A4
    A2 --> D1
    A4 --> D2
    A3 --> D3
    A3 --> E1 & E3
    A5 --> E1 & E4 & E5
    A6 --> E2

partnerships-os/
├── apps/
│   ├── api/                     # Fastify 5 backend
│   │   ├── src/
│   │   │   ├── auth/            # Google OAuth + JWT + domain guard
│   │   │   ├── contacts/        # Contact CRUD + research trigger
│   │   │   ├── interactions/    # Interaction logging
│   │   │   ├── members/         # Internal team management
│   │   │   ├── graph/           # Neo4j ops, RAG search, discovery
│   │   │   ├── research/        # AI enrichment pipeline + enrichers
│   │   │   ├── voice/           # Voice agent orchestrator + handlers
│   │   │   ├── notion/          # Bi-directional sync engine
│   │   │   ├── jobs/            # BullMQ workers + cron
│   │   │   └── config/          # Env, DB connections, approved members
│   │   ├── prisma/              # Schema + migrations
│   │   └── tests/
│   ├── web/                     # Next.js 15 dashboard
│   │   └── src/
│   │       ├── app/             # App Router (dashboard, graph, contacts, discover)
│   │       ├── components/      # shadcn/ui, D3 graph, charts
│   │       ├── hooks/
│   │       └── lib/             # API client, auth
│   └── mobile/                  # Expo voice-first app
│       ├── app/                 # Expo Router screens
│       ├── components/          # VoiceButton, Waveform, Transcript
│       ├── services/            # Voice WebSocket, API, auth
│       └── stores/              # Zustand state
├── packages/
│   └── shared/                  # TypeScript types + Zod schemas
├── scripts/                     # Seed, migrations, Notion setup
├── docker-compose.yml           # PostgreSQL + pgvector, Neo4j, Redis
├── turbo.json
└── pnpm-workspace.yaml

• Node.js 20+
• pnpm 9+
• Docker (for PostgreSQL, Neo4j, Redis)

# Clone the repository
git clone https://github.com/JiwaniZakir/Partnerships_OS.git
cd Partnerships_OS

# Install dependencies
pnpm install

# Start infrastructure (PostgreSQL + pgvector, Neo4j, Redis)
docker compose up -d

# Configure environment
cp .env.example .env
# Add your API keys (Anthropic, OpenAI, Deepgram, Tavily, Notion, Google OAuth)

# Run database migrations
pnpm db:migrate
pnpm neo4j:migrate

# Seed with sample data
pnpm db:seed

# Start all apps in development
pnpm dev

(:Contact)-[:WORKS_AT {title, since}]->(:Organization)
(:Contact)-[:KNOWS {context, strength}]->(:Contact)
(:Member)-[:ONBOARDED {date, context}]->(:Contact)
(:Member)-[:HAD_INTERACTION {type, date}]->(:Contact)
(:Contact)-[:TAGGED_AS]->(:Tag)
(:Contact)-[:IN_GENRE]->(:Genre)
(:Organization)-[:PARTNERED_WITH]->(:Organization)

Contributions are welcome! Please see CONTRIBUTING.md for guidelines on how to get started.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the MIT License — see the LICENSE file for details.