{"id":24472429,"url":"https://github.com/abdulbasit110/nextjs-fastapi","last_synced_at":"2026-04-16T10:02:14.346Z","repository":{"id":272175900,"uuid":"914903690","full_name":"Abdulbasit110/nextjs-fastapi","owner":"Abdulbasit110","description":"ACE AI - Multi Agent RAG, one stop exam preparation applicaiton for students powered by langchain, vercel ai sdk, openai, fastapi, pinecone and nextjs ","archived":false,"fork":false,"pushed_at":"2025-02-06T13:47:22.000Z","size":341,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-14T14:29:28.250Z","etag":null,"topics":["fastapi","langchain","nextjs","openai","rag","vercel-ai-sdk"],"latest_commit_sha":null,"homepage":"https://ace-ai-ashen.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/Abdulbasit110.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":"2025-01-10T14:49:01.000Z","updated_at":"2025-02-06T13:47:28.000Z","dependencies_parsed_at":"2025-01-20T19:26:39.322Z","dependency_job_id":"c3542e3c-6fa4-4743-8164-8a1e6bdfd03c","html_url":"https://github.com/Abdulbasit110/nextjs-fastapi","commit_stats":null,"previous_names":["abdulbasit110/ace-ai","abdulbasit110/nextjs-fastapi"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Abdulbasit110/nextjs-fastapi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abdulbasit110%2Fnextjs-fastapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abdulbasit110%2Fnextjs-fastapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abdulbasit110%2Fnextjs-fastapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abdulbasit110%2Fnextjs-fastapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Abdulbasit110","download_url":"https://codeload.github.com/Abdulbasit110/nextjs-fastapi/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abdulbasit110%2Fnextjs-fastapi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31880883,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T09:23:21.276Z","status":"ssl_error","status_checked_at":"2026-04-16T09:23:15.028Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["fastapi","langchain","nextjs","openai","rag","vercel-ai-sdk"],"created_at":"2025-01-21T08:12:18.294Z","updated_at":"2026-04-16T10:02:14.330Z","avatar_url":"https://github.com/Abdulbasit110.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AceAI\n\nAceAI is a full-stack AI-powered application built with a **Next.js frontend** and a **FastAPI backend**. It provides features like document processing, AI-driven chat, quiz generation, note-taking, and web search.\n\n---\n\n## Features\n\n- **Document Upload**: Upload documents (e.g., PDFs, text files) for AI processing.\n- **AI-Powered Chat**: Chat with context derived from uploaded documents.\n- **Quiz and Notes Generation**: Generate quizzes and notes from document content.\n- **Web Search Agent**: Perform web searches with AI-generated responses.\n- **RAG (Retrieval Augmented Generation)**: Use AI to generate responses with context retrieval.\n\n---\n\n## Project Structure\n\n```\nproject-root/\n├── app/                    # FastAPI backend\n│   ├── core/               # Configurations and dependencies\n│   ├── routers/            # API routes\n│   ├── services/           # Business logic\n│   ├── main.py             # FastAPI entry point\n│   ├── requirements.txt    # Backend dependencies\n├── app/                  # Next.js frontend routing\n├── public/                 # Public assets (images, icons, etc.)\n├── components/             # Reusable UI components\n├── styles/                 # CSS for styling\n├── next.config.js          # Next.js configuration\n├── package.json            # Frontend dependencies and scripts\n├── .env                    # Environment variables\n└── README.md               # Documentation\n```\n\n---\n\n## Getting Started\n\n### Backend (FastAPI)\n\n1. Navigate to the backend directory:\n   ```bash\n   cd api\n   ```\n\n2. Create and activate a virtual environment:\n   ```bash\n   python3 -m venv venv\n   source venv/bin/activate  # For Windows: venv\\Scripts\\activate\n   ```\n\n3. Install backend dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. Start the backend server:\n   ```bash\n   uvicorn app.main:app --reload\n   ```\n   The backend will run at `http://127.0.0.1:8000`.\n\n---\n\n### Frontend (Next.js)\n\n1. Install frontend dependencies:\n   ```bash\n   npm install\n   ```\n\n2. Start the Next.js development server:\n   ```bash\n   npm run dev\n   ```\n   The frontend will run at `http://localhost:3000`.\n\n---\n\n## Environment Variables\n\n### Backend `.env`\nCreate a `.env` file in the root directory with the following variables:\n\n```env\nOPENAI_API_KEY=your_openai_api_key\nSERPAPI_API_KEY=your_serpapi_api_key\nUPLOAD_DIRECTORY=uploads/\n```\n\n### Frontend `.env`\nCreate a `.env` file in the root directory with:\n\n```env\nNEXT_PUBLIC_BACKEND_URL=http://127.0.0.1:8000/\n```\n\n---\n\n## Deployment\n\n### Vercel (Frontend and Backend)\n\n1. **Frontend**: Deploy the Next.js app using the Vercel CLI:\n   ```bash\n   vercel --prod\n   ```\n\n2. **Backend**: Configure `vercel.json` in the `api/` directory:\n   ```json\n   {\n     \"builds\": [\n       {\n         \"src\": \"main.py\",\n         \"use\": \"@vercel/python\"\n       }\n     ],\n     \"routes\": [\n       {\n         \"src\": \"/(.*)\",\n         \"dest\": \"main.py\"\n       }\n     ]\n   }\n   ```\n\n   Deploy the FastAPI backend:\n   ```bash\n   vercel --prod\n   ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdulbasit110%2Fnextjs-fastapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabdulbasit110%2Fnextjs-fastapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdulbasit110%2Fnextjs-fastapi/lists"}