🤖 Your Workspace Padi & Gist Partner - Transform scattered workplace conversations and documents into accessible, intelligent insights.

Amebo is an enterprise-grade SaaS platform that serves as your team's intelligent knowledge companion. It transforms your Slack conversations, uploaded documents, and institutional knowledge into a searchable, AI-powered Q&A system.

• Instant Knowledge Access - Find answers in seconds, not minutes
• Context-Aware Intelligence - Understands conversation threads and document relationships
• Multi-Workspace Support - Manage multiple Slack workspaces from one dashboard
• Enterprise Security - Multi-tenant architecture with encrypted credential storage
• Seamless Integration - Works in Slack via /ask commands and web dashboard

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Next.js 14    │    │   FastAPI        │    │   PostgreSQL    │
│   Frontend       │◄──►│   Backend        │◄──►│   Database      │
│   Dashboard      │    │   API Server     │    │   Multi-tenant  │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                                │
                       ┌────────┴────────┐
                       │                 │
                ┌──────▼──────┐   ┌─────▼─────┐
                │  ChromaDB   │   │   Slack   │
                │  Vector DB  │   │    API    │
                │  Semantic   │   │ Real-time │
                │   Search    │   │   Sync    │
                └─────────────┘   └───────────┘

slack-helper/
├── 📂 backend/              # Python FastAPI backend
│   ├── src/
│   │   ├── api/             # REST API routes
│   │   ├── services/        # Business logic
│   │   ├── db/              # Database connections
│   │   └── models/          # Data models
│   ├── requirements.txt     # Python dependencies
│   └── README.md           # Backend setup guide
├── 📂 frontend/             # Next.js 14 frontend
│   ├── app/                # App router pages
│   ├── src/
│   │   ├── components/     # React components
│   │   ├── hooks/          # Custom React hooks
│   │   ├── lib/            # Utilities & API client
│   │   └── store/          # State management
│   ├── package.json        # Node dependencies
│   └── README.md          # Frontend setup guide
├── 📂 docs/                # Documentation
│   ├── ARCHITECTURE.md     # System architecture
│   ├── API.md             # API documentation
│   └── DEPLOYMENT.md      # Deployment guide
└── README.md              # This file

• Python 3.9+
• Node.js 18+
• PostgreSQL 13+
• Slack App with Bot Token

git clone <repository-url>
cd slack-helper

cd backend
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt

# Set environment variables
cp .env.example .env
# Edit .env with your database and API keys

# Start backend
python run_server.py

cd frontend
npm install

# Set environment variables
cp .env.example .env.local
# Edit .env.local with your API URL

# Start frontend
npm run dev

• Frontend Dashboard: http://localhost:3000
• Backend API: http://localhost:8000
• API Documentation: http://localhost:8000/docs

• Natural language processing with Anthropic Claude
• Context-aware responses from Slack messages and documents
• Source attribution with confidence scoring
• Real-time search across indexed content

• Secure workspace isolation with 4-layer architecture
• Multiple Slack workspace integration per organization
• Encrypted credential storage using Fernet encryption
• Automated message backfilling with configurable schedules

• Multi-format support (PDF, DOCX, TXT, Markdown)
• Automatic text extraction and chunking
• Vector indexing for semantic search
• Workspace-specific document tagging

• Role-based access control (Admin, Member, Viewer)
• User invitation system with email notifications
• Team management with activation/deactivation
• Organization-level settings and AI configuration

• Multi-tenant data isolation
• JWT authentication with secure token handling
• Encrypted credential storage
• CORS protection and input validation

• FastAPI - High-performance Python web framework
• PostgreSQL - Relational database for structured data
• ChromaDB - Vector database for semantic search
• APScheduler - Background task automation
• Slack SDK - Real-time Slack integration
• Anthropic Claude - AI language model for Q&A

• Next.js 14 - React framework with App Router
• TypeScript - Type-safe JavaScript
• Tailwind CSS - Utility-first CSS framework
• shadcn/ui - Modern React component library
• TanStack Query - Data fetching and caching
• Zustand - Lightweight state management

• Docker - Containerization
• PostgreSQL - Primary database
• ChromaDB - Vector embeddings storage
• JWT - Authentication tokens

• Backend Setup Guide - Detailed backend installation and configuration
• Frontend Setup Guide - Frontend development environment setup
• Architecture Documentation - System design and component interactions
• API Documentation - REST API endpoints and usage
• Deployment Guide - Production deployment instructions

1. Fork the repository
2. Create a 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.

• Built with Amazon Q Developer for accelerated development
• Powered by Anthropic Claude for intelligent responses
• UI components from shadcn/ui

Made with ❤️ and Amazon Q Developer