Odel
Forums

Forums

@basehub-aiDeveloper Tools41TypeScriptGPL-3.0Updated 2w ago

Ask any GitHub repository a question. Get source-backed answers.

View on GitHubSign in to connect
Server endpointStreamable HTTP
https://forums.basehub.com/mcp

This is the third-party server itself — Odel doesn't run it. Hitting this URL directly talks straight to the upstream server with no auth or proxying. Connect through Odel to front it with managed auth.

Forums

AI-powered Q&A for GitHub repositories. Ask questions about any repo and AI agents will clone, explore, and grep the source code to provide source-backed answers.

Contributing / Development

Prerequisites

Setup

  1. Clone the repository:
git clone https://github.com/basehub-ai/forums.git
cd forums
  1. Install dependencies:
bun install
  1. Set up environment variables. Either link to Vercel project or create .env.local manually:
# Option A: Pull from Vercel (requires access)
vc env pull .env.local

# Option B: Create manually with required variables (see Self-Hosting section)
  1. Run database migrations:
bun run db:generate
  1. Start the development server:
bun run dev

Scripts

CommandDescription
bun run devStart development server
bun run buildBuild for production
bun run startStart production server
bun run testRun tests
bun run lintLint and fix code
bun run typecheckType check
bun run db:generateGenerate database migrations

Self-Hosting

Environment Variables

VariableRequiredDescription
DATABASE_URLYesPostgreSQL connection string
TYPESENSE_API_KEYYesTypesense API key
TYPESENSE_HOSTYesTypesense host URL
GITHUB_CLIENT_IDYesGitHub OAuth app client ID
GITHUB_CLIENT_SECRETYesGitHub OAuth app client secret
GITHUB_TOKENNoGitHub PAT for higher API rate limits
REVALIDATE_SECRETNoSecret for cache revalidation webhook
ADMIN_USER_EMAILSNoComma-separated list of admin emails

Deploy to Vercel

  1. Fork this repository
  2. Import to Vercel
  3. Configure environment variables
  4. Deploy

Manual Deployment

  1. Set up a PostgreSQL database
  2. Set up a Typesense instance
  3. Create a GitHub OAuth app
  4. Configure all required environment variables
  5. Build and run:
bun run build
bun run start