A privacy-preserving, multi-agent research platform for blockchain governance, inspired by Open WebUI and designed for BGIN Block 13 sessions. This project implements the principles outlined in the BGIN Agentic Framework Archive Codex to create a sovereign, dignity-based, privacy-preserving AI agent ecosystem.
- ✅ Ollama Integration: Local LLM processing with
llama3.2:3b-instruct-q4_0 - ✅ Block 13 Conference Sessions: 19 sessions across 5 working groups
- ✅ Multi Agent Hub: Collaborative conference discussions
- ✅ Chat Persistence: Session-specific chat history with project containers
- ✅ Discourse Integration: Publish insights to public forums
- ✅ Track-Based Organization: BGIN Agent Hack, IKP, Cyber Security, FASE, General
- 🔄 Phala Cloud Integration: Ready for future confidential compute deployment
- 🔄 Advanced Privacy Features: ToIP, FPP, Privacy Pools (architecture ready)
-
Archive Agent - Knowledge & RAG Systems (Blue theme)
- Document analysis and knowledge synthesis
- Cross-session search and retrieval
- Privacy-preserving knowledge management
- Distributed consciousness architecture
- Kwaai Integration: Privacy-preserving analytics and insights
- FPP Compliance: Data sovereignty and user-controlled research data
- ToIP Framework: DID-based identity and verifiable credentials
- Privacy Pools: ASP eligibility for research contributions
-
Codex Agent - Policy & Standards Management (Purple theme)
- Policy analysis and standards development
- Compliance checking and verification
- Real-time sovereignty enforcement
- Cryptoeconomic verification systems
- FPP Integration: Dignity-based governance and policy analysis
- ToIP Framework: Policy analysis credentials and trust protocols
- Privacy Pools: Trust-based policy compliance verification
-
Discourse Agent - Communications & Collaboration (Green theme)
- BGIN Discourse community integration (bgin.discourse.group)
- Forum integration and community management
- Consensus building and collaboration tools
- Privacy-preserving communication channels
- Trust network visualization
- FPP Integration: Dignity-based community building and consensus
- ToIP Framework: Trust network establishment and management
- Privacy Pools: Community-driven ASP qualification process
- 19 Conference Sessions across 5 working groups
- Multi Agent Hub for collaborative conference discussions
- Track-Based Organization (BGIN Agent Hack, IKP, Cyber Security, FASE, General)
- Session-Specific Chat History with project containers
- Discourse Integration for publishing insights to public forums
- DID-based Identity Management: Decentralized identifier system
- Privacy Level Controls: Maximum/High/Selective/Minimal privacy settings
- Trust Network Visualization: Anonymous researcher interactions
- Privacy-Preserving Research Platform: End-to-end encrypted communications
- Real-time Sovereignty Enforcement: Continuous privacy compliance monitoring
- Privacy-Preserving Analytics: Advanced privacy-preserving data analysis
- Selective Disclosure: Granular control over data sharing
- Zero-Knowledge Proofs: Prove capabilities without revealing data
- Privacy-First Architecture: Built-in privacy controls and anonymization
- Data Sovereignty: User-controlled data and digital identity
- Dignity-Based Economics: Fair value distribution and user agency
- Privacy by Design: Privacy built into system architecture
- Transparent Governance: Open and accountable decision-making
- Layer 1 (Utility): Agent DIDs and verifiable credentials
- Layer 2 (Governance): Agent governance policies and trust protocols
- Layer 3 (Credential): Capability credentials and research verification
- Layer 4 (Application): Multi-agent interface with trust visualization
- Association Set Provider (ASP): Trust-based deposit approval system
- Research Contribution Rewards: Economic incentives for quality contributions
- Privacy-Preserving Transactions: Zero-knowledge proof integration
- Trust Network Economics: Reputation-based access to enhanced features
- Model configuration panel
- Conversation history management
- File upload capabilities
- Real-time agent status monitoring
- Multi-agent collaboration mode
- Trust network visualization
- Node.js 18+
- npm 9+
- Git
- Ollama (for local LLM) - Install Ollama
- PostgreSQL (for production)
- Redis (for caching)
- Clone the repository
git clone https://github.com/mitchuski/bgin-agents.git
cd bgin-agents- Install dependencies
npm install- Set up environment
cp env.example .env
# Edit .env with your configuration- Install and start Ollama
# Download and install Ollama from https://ollama.ai/
ollama pull llama3.2:3b-instruct-q4_0- Start development servers
# Option 1: Full development environment
npm run dev
# Option 2: Simple server (recommended for Block 13)
npm run dev:simple- Access the interface
- Frontend: http://localhost:4000
- Backend API: http://localhost:4000/api
- Health Check: http://localhost:4000/health
- Framework: React 18 with TypeScript
- Styling: Tailwind CSS
- Icons: Lucide React
- State Management: React Hooks + Context + Zustand
- Build Tool: Vite
- Real-time: Socket.io Client
- Framework: Express.js
- Database: PostgreSQL (with Redis for caching)
- Authentication: JWT + DID-based
- Real-time: Socket.io
- AI Integration: OpenAI, Anthropic, Ollama
- Privacy: End-to-end encryption, privacy-preserving analytics
- Archive Agent: Document analysis, knowledge synthesis, cross-session search
- Codex Agent: Policy analysis, standards development, compliance checking
- Discourse Agent: Forum integration, consensus building, community management
Based on the BGIN Agentic Framework Archive Codex, this implementation features:
- Distributed Consciousness: Multi-agent coordination with privacy preservation
- Privacy by Design: Built-in privacy controls and data protection
- Dignity-based Economics: Fair value distribution and user sovereignty
- Real-time Sovereignty Enforcement: Continuous monitoring of privacy compliance
- Cryptoeconomic Verification: Blockchain-based trust and verification systems
# Development
npm run dev # Start both frontend and backend
npm run dev:simple # Start with simple backend
npm run build # Build for production
npm run start # Start production server
# Testing
npm run test # Run tests
npm run test:coverage # Run tests with coverage
npm run lint # Lint code
npm run lint:fix # Fix linting issues
# Database
npm run db:migrate # Run database migrations
npm run db:seed # Seed database
npm run agents:seed # Seed agent databgin-ai-mvp/
├── frontend/ # React frontend
│ ├── src/
│ │ ├── components/ # React components
│ │ │ ├── BGINMultiAgentInterface.tsx
│ │ │ ├── agents/ # Agent-specific components
│ │ │ ├── privacy/ # Privacy components
│ │ │ └── trust/ # Trust network components
│ │ ├── contexts/ # React contexts
│ │ ├── hooks/ # Custom hooks
│ │ ├── services/ # API services
│ │ └── types/ # TypeScript types
│ └── package.json
├── backend/ # Node.js backend
│ ├── src/
│ │ ├── agents/ # Agent implementations
│ │ │ ├── archive/ # Archive Agent
│ │ │ ├── codex/ # Codex Agent
│ │ │ └── discourse/ # Discourse Agent
│ │ ├── routes/ # API routes
│ │ ├── middleware/ # Express middleware
│ │ ├── services/ # Business logic
│ │ ├── privacy/ # Privacy-preserving systems
│ │ ├── trust/ # Trust network systems
│ │ └── utils/ # Utilities
│ └── package.json
├── database/ # Database schemas
├── docs/ # Documentation
├── scripts/ # Setup scripts
└── infrastructure/ # Deployment configurations
- DID-based Identity: Decentralized identifier management using W3C standards
- Privacy Levels: Configurable privacy controls (Maximum/High/Selective/Minimal)
- Trust Networks: Anonymous researcher interactions with reputation systems
- Data Encryption: End-to-end encryption for sensitive data
- Audit Logging: Comprehensive activity tracking with privacy preservation
- JWT Authentication: Secure token-based authentication
- Rate Limiting: Protection against abuse and DoS attacks
- Input Validation: Comprehensive input sanitization
- CORS Protection: Cross-origin resource sharing controls
- Helmet Security: Security headers and protections
- Kwaai: Privacy-preserving analytics and insights
- BGIN Discourse: Community forum integration (bgin.discourse.group)
- OpenAI/Anthropic: AI model integration
- Ollama: Local AI model support
- BGIN Systems: Blockchain governance integration
- Privacy-Preserving Analytics: Advanced data analysis with privacy protection
- Selective Disclosure Protocols: Granular control over data sharing
- Zero-Knowledge Proofs: Cryptographic proofs without data revelation
- Privacy-First Architecture: Built-in privacy controls and anonymization
- Data Sovereignty: User-controlled data and digital identity
- Dignity-Based Economics: Fair value distribution and user agency
- Privacy by Design: Privacy built into system architecture
- Transparent Governance: Open and accountable decision-making
- Decentralized Identifiers (DIDs): Agent identity management
- Verifiable Credentials: Cryptographic proof of capabilities
- Trust Networks: Reputation and relationship management
- Interoperability: Standards-compliant agent interactions
- Association Set Provider (ASP): Trust-based deposit approval
- Research Contribution Economics: Financial incentives for quality research
- Privacy-Preserving Transactions: Zero-knowledge proof integration
- Trust Network Economics: Reputation-based access to enhanced features
GET /api/agents- List available agentsGET /api/sessions- List Block 13 sessionsPOST /api/chat- Send message to agentGET /api/synthesis- Cross-session synthesis
GET /api/trust- Trust network dataPOST /api/privacy- Privacy settingsGET /api/dids- Decentralized identifier managementPOST /api/credentials- Verifiable credential operations
POST /api/kwaai/analytics- Kwaai privacy-preserving analyticsGET /api/fpp/sovereignty- FPP data sovereignty controlsPOST /api/toip/trust- ToIP trust relationship managementGET /api/privacy-pools/asp- Privacy Pools ASP statusPOST /api/privacy-pools/contribution- Research contribution tracking
POST /api/auth- Authentication endpointsGET /api/auth/did- DID-based authenticationPOST /api/auth/verify- Credential verification
- Real-time agent status monitoring
- Performance metrics and analytics
- Cross-session insights
- Sovereignty enforcement monitoring
- Kwaai Integration: Privacy-preserving analytics performance
- FPP Compliance: Data sovereignty and dignity metrics tracking
- ToIP Framework: Trust network and credential verification status
- Privacy Pools: ASP eligibility and contribution tracking
- Trust network visualization
- Privacy compliance tracking
- DID management and verification status
- Verifiable credential lifecycle monitoring
docker-compose up -ddocker-compose -f docker-compose.production.yml up -dWe welcome contributions to the BGIN Multi-Agent Interface project. This project follows the principles outlined in the BGIN Agentic Framework Archive Codex for sovereign, dignity-based AI development.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Follow privacy-by-design principles in all contributions
- Ensure dignity-based economics in any economic features
- Maintain sovereignty enforcement in all agent interactions
- Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- TypeScript for type safety
- ESLint for code quality
- Prettier for code formatting
- Jest for testing
- Privacy-preserving design patterns
This project is licensed under the MIT License - see the LICENSE file for details.
- BGIN Community for governance research and collaboration
- Open WebUI for interface inspiration and design patterns
- Block 13 participants for feedback and testing
- Privacy-preserving technology community for foundational work
- Soul Sync for the BGIN Agentic Framework Archive Codex reference document
For support and questions:
- Create an issue in this repository
- Contact the BGIN community
- Check the documentation in
/docs - Reference the BGIN Agentic Framework Archive Codex for architectural guidance
- BGIN Agentic Framework Archive Codex - Comprehensive framework for sovereign AI agents
- BGIN Official Website - Blockchain Governance Initiative Network
- BGIN Discourse Community - BGIN Community Forum and Working Groups
- Kwaai Privacy Platform - Privacy-preserving analytics and insights
- First Person Project (FPP) - Dignity-based data sovereignty
- Trust over IP (ToIP) Foundation - Trust framework for digital ecosystems
- Privacy Pools - Privacy-preserving financial transactions
- W3C DID Specification - Decentralized Identifiers
- W3C Verifiable Credentials - Verifiable Credentials
- Open WebUI - Interface inspiration
Built with ❤️ for the BGIN Community
This project implements the principles of distributed consciousness, privacy by design, dignity-based economics, and real-time sovereignty enforcement as outlined in the BGIN Agentic Framework Archive Codex. The Block 13 MVP showcases the integration of Kwaai privacy platform, First Person Project (FPP) compliance, Trust over IP (ToIP) framework, and Privacy Pools to create a comprehensive agentic framework for blockchain governance research and collaboration.