{
  "markdown": "# Forums\n\nAI-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.\n\n## Contributing / Development\n\n### Prerequisites\n\n- [Bun](https://bun.sh) runtime\n- [Vercel CLI](https://vercel.com/cli) (for pulling environment variables)\n- PostgreSQL database\n- [Typesense](https://typesense.org) instance\n\n### Setup\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/basehub-ai/forums.git\ncd forums\n```\n\n2. Install dependencies:\n\n```bash\nbun install\n```\n\n3. Set up environment variables. Either link to Vercel project or create `.env.local` manually:\n\n```bash\n# Option A: Pull from Vercel (requires access)\nvc env pull .env.local\n\n# Option B: Create manually with required variables (see Self-Hosting section)\n```\n\n4. Run database migrations:\n\n```bash\nbun run db:generate\n```\n\n5. Start the development server:\n\n```bash\nbun run dev\n```\n\n### Scripts\n\n| Command | Description |\n|---------|-------------|\n| `bun run dev` | Start development server |\n| `bun run build` | Build for production |\n| `bun run start` | Start production server |\n| `bun run test` | Run tests |\n| `bun run lint` | Lint and fix code |\n| `bun run typecheck` | Type check |\n| `bun run db:generate` | Generate database migrations |\n\n## Self-Hosting\n\n### Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `DATABASE_URL` | Yes | PostgreSQL connection string |\n| `TYPESENSE_API_KEY` | Yes | Typesense API key |\n| `TYPESENSE_HOST` | Yes | Typesense host URL |\n| `GITHUB_CLIENT_ID` | Yes | GitHub OAuth app client ID |\n| `GITHUB_CLIENT_SECRET` | Yes | GitHub OAuth app client secret |\n| `GITHUB_TOKEN` | No | GitHub PAT for higher API rate limits |\n| `REVALIDATE_SECRET` | No | Secret for cache revalidation webhook |\n| `ADMIN_USER_EMAILS` | No | Comma-separated list of admin emails |\n\n### Deploy to Vercel\n\n1. Fork this repository\n2. Import to Vercel\n3. Configure environment variables\n4. Deploy\n\n### Manual Deployment\n\n1. Set up a PostgreSQL database\n2. Set up a Typesense instance\n3. Create a GitHub OAuth app\n4. Configure all required environment variables\n5. Build and run:\n\n```bash\nbun run build\nbun run start\n```\n",
  "bytes": 2241,
  "sha": "e148d084976e811062d133392dba5a12d0e1189156df535dd826766cddd24d2b",
  "repo_slug": "basehub-ai/forums",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_basehub_ai_forums_758fa356/readme"
}