{"id":23458181,"url":"https://github.com/preston176/nexusai","last_synced_at":"2025-10-30T21:31:28.682Z","repository":{"id":268266416,"uuid":"903805441","full_name":"preston176/nexusAI","owner":"preston176","description":"Nexus AI is an innovative platform designed to empower users by securely storing their documents and providing intelligent, document-based responses","archived":false,"fork":false,"pushed_at":"2025-02-11T06:51:24.000Z","size":892,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-11T07:32:04.705Z","etag":null,"topics":["clerk-authentication","customhooks","firebase","langchain","nextjs15","paystack","pinecone"],"latest_commit_sha":null,"homepage":"https://nexusai-pdf.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/preston176.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-15T15:53:27.000Z","updated_at":"2025-02-11T06:51:28.000Z","dependencies_parsed_at":"2025-01-08T11:28:17.554Z","dependency_job_id":"0e68f6fe-1f04-4180-bfff-13b5996a3d44","html_url":"https://github.com/preston176/nexusAI","commit_stats":null,"previous_names":["preston176/nexusai"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/preston176%2FnexusAI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/preston176%2FnexusAI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/preston176%2FnexusAI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/preston176%2FnexusAI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/preston176","download_url":"https://codeload.github.com/preston176/nexusAI/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239066609,"owners_count":19575904,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clerk-authentication","customhooks","firebase","langchain","nextjs15","paystack","pinecone"],"created_at":"2024-12-24T05:17:11.733Z","updated_at":"2025-10-30T21:31:28.676Z","avatar_url":"https://github.com/preston176.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- Nexus AI - Landing Section --\u003e\n\n\u003ch1 align=\"center\"\u003e🚀 Nexus AI\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\u003cem\u003eSecure, Scalable Document Chat Powered by GPT-4o\u003c/em\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.producthunt.com/posts/nexus-ai-3\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=939232\u0026theme=neutral\u0026t=1741334380807\" alt=\"Nexus AI on Product Hunt\" style=\"max-width: 100%;\" /\u003e\n  \u003c/a\u003e\n\n\u003c!-- GitHub Repository Badges --\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/preston176/nexusAI\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/preston176/nexusAI?style=social\" alt=\"GitHub stars\" /\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://github.com/preston176/nexusAI/issues\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues/preston176/nexusAI\" alt=\"GitHub issues\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/preston176/nexusAI\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/last-commit/preston176/nexusAI\" alt=\"Last commit\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\n\u003c!-- Landing Page Preview Section --\u003e\n\n\u003ch2 id=\"landing-page\"\u003e🌐 Screenshot\u003c/h2\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://nexusai-pdf.vercel.app\" target=\"_blank\"\u003e\n    \u003cimg src=\"/public/demo.png\" alt=\"Nexus AI Screenshot\" style=\"border-radius: 8px; max-width: 100%; box-shadow: 0 4px 14px rgba(0, 0, 0, 0.1);\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://nexusai-pdf.vercel.app\" target=\"_blank\" style=\"margin-right: 12px;\"\u003e\n    🌐 \u003cstrong\u003eLive App\u003c/strong\u003e\n  \u003c/a\u003e\n  |\n  \u003ca href=\"https://youtu.be/ABdXAWunyuc\" target=\"_blank\" style=\"margin-left: 12px;\"\u003e\n    🎥 \u003cstrong\u003eWatch Demo\u003c/strong\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003c!-- Overview Section --\u003e\n\n\u003ch2\u003e📄 Overview\u003c/h2\u003e\n\n\u003cdiv\u003e\n  \u003cstrong\u003eNexus AI\u003c/strong\u003e is a full-stack web application that enables users to securely upload and interact with documents via conversational AI.\n  \u003cbr\u003e\u003cbr\u003e\n  It combines:\n  \u003cul\u003e\n    \u003cli\u003e🔐 Modern Authentication\u003c/li\u003e\n    \u003cli\u003e☁️ Cloud Storage\u003c/li\u003e\n    \u003cli\u003e🧠 Vector Indexing\u003c/li\u003e\n    \u003cli\u003e🤖 Multi-provider LLM orchestration via \u003cstrong\u003eLangChain\u003c/strong\u003e\u003c/li\u003e\n  \u003c/ul\u003e\n  \u003cbr\u003e\n  \u003cstrong\u003eKey Use Cases:\u003c/strong\u003e\n  \u003cul\u003e\n    \u003cli\u003e📑 Document Search\u003c/li\u003e\n    \u003cli\u003e✅ Compliance QA\u003c/li\u003e\n    \u003cli\u003e🧾 Personal Knowledge Base\u003c/li\u003e\n    \u003cli\u003e🔍 AI Research Assistant\u003c/li\u003e\n  \u003c/ul\u003e\n\u003c/div\u003e\n\n## Architecture\n\n```mermaid\ngraph TD\n  User[🧑 User] --\u003e UI[🌐 Nexus AI App]\n  UI --\u003e Auth[🔐 Sign In\u003cbr\u003evia Clerk]\n  UI --\u003e Upload[📄 Upload Document]\n  Upload --\u003e Store[☁️ Saved to Cloud\u003cbr\u003eFirebase]\n  Upload --\u003e Understand[🤖 Analyze Content\u003cbr\u003ewith AI]\n  Understand --\u003e Ask[❓ Ask a Question]\n  Ask --\u003e Search[🔎 Find Relevant Info]\n  Search --\u003e Respond[Get response\u003cbr\u003efrom LLM]\n  UI --\u003e Pay[💳 Upgrade Plan\u003cbr\u003evia Paystack]\n```\n\n---\n\n## Features\n\n- 🔐 **Multi-factor Authentication** with Clerk\n- 📄 **PDF Storage** using Firebase Cloud Storage\n- 🧠 **LLM Orchestration** via LangChain\n- 🔎 **Vector Search** using Pinecone\n- 💬 **Multi-LLM Support**: GPT-4o, Gemini, Azure, Groq\n- 💳 **Subscription Billing** powered by Paystack\n- 🐳 **Docker Compatible** with environment-driven config\n\n---\n\n## Technology Stack\n\n| Layer         | Technology                             |\n| ------------- | -------------------------------------- |\n| Frontend      | Next.js, TailwindCSS                   |\n| Auth          | Clerk.dev                              |\n| File Storage  | Firebase Cloud Storage                 |\n| Vector Search | Pinecone                               |\n| LLM Runtime   | LangChain                              |\n| LLM Providers | OpenAI, Gemini, Azure OpenAI, Groq     |\n| Payments      | Paystack                               |\n| Deployment    | Docker, Vercel                         |\n\n---\n\n## Setup\n\n### Local Development\n\n```bash\ngit clone https://github.com/preston176/nexusAI\ncd nexusAI\nnpm install\nnpm run dev\n```\n\nApp will be available at `http://localhost:3000`.\n\n---\n\n### Environment Variables\n\nCreate a `.env` file with the following:\n\n```env\n# Clerk Auth\nNEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=...\nCLERK_SECRET_KEY=...\n\n# Pinecone\nNEXT_PUBLIC_PINECONE_API_KEY=...\n\n# LLM APIs\nNEXT_PUBLIC_GEMINI_API_KEY=...\nOPENAI_API_KEY=...\nGROQ_API_KEY=...\n\n# Paystack\nNEXT_PUBLIC_PAYSTECK_PUBLISHABLE_KEY=...\nPAYSTACK_API_KEY=...\nNEXT_PUBLIC_PAYSTACK_PUBLIC_KEY=...\nPAYSTACK_WEBHOOK_SECRET=...\n\n# Firebase\nFIREBASE_STORAGE_BUCKET=nexusai-pdf.firebasestorage.app\nFIREBASE_SERVICE_ACCOUNT_JSON=\u003cbase64 encoded service_key.json\u003e\n\n# reCAPTCHA / Forms\nNEXT_PUBLIC_RECAPTCHA_SITE_KEY=...\nNEXT_PUBLIC_FORMSPREE_API=...\n```\n\n### Optional: Azure OpenAI Integration\n\n```env\nAZURE_OPENAI_API_INSTANCE_NAME=...\nAZURE_OPENAI_API_KEY=...\nAZURE_OPENAI_API_VERSION=\"2024-02-01\"\nAZURE_OPENAI_API_EMBEDDINGS_DEPLOYMENT_NAME=\"text-embedding-ada-002\"\n```\n\n---\n\n## Docker Support\n\n```bash\ndocker build -t nexusai-pdf .\ndocker run -p 3000:3000 --env-file .env nexusai-pdf\n```\n\n---\n\n## License\n\nMIT License\n\n---\n\n## Author\n\nBuilt by [Preston Mayieka](https://preston176.vercel.app)  \nGitHub: [@preston176](https://github.com/preston176)  \nTwitter: [@preston_mayieka](https://twitter.com/preston_mayieka)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpreston176%2Fnexusai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpreston176%2Fnexusai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpreston176%2Fnexusai/lists"}