{"id":29064294,"url":"https://github.com/qwerryfiwy/neurax","last_synced_at":"2026-04-08T20:03:20.303Z","repository":{"id":300449907,"uuid":"1005931682","full_name":"qwerryfiwy/NeuraX","owner":"qwerryfiwy","description":"NeuraX is an AI assistant powered by AzureOpenAI.","archived":false,"fork":false,"pushed_at":"2025-12-12T13:21:06.000Z","size":9897,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-14T04:12:03.736Z","etag":null,"topics":["ai","azureopenai","dotenv","fastapi","framer-motion","nextjs","python","tailwindcss"],"latest_commit_sha":null,"homepage":"https://neura-x-eight.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/qwerryfiwy.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,"zenodo":null}},"created_at":"2025-06-21T05:39:47.000Z","updated_at":"2025-12-12T13:21:11.000Z","dependencies_parsed_at":"2025-06-21T19:43:35.612Z","dependency_job_id":null,"html_url":"https://github.com/qwerryfiwy/NeuraX","commit_stats":null,"previous_names":["qwerryfiwy/neurax"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/qwerryfiwy/NeuraX","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qwerryfiwy%2FNeuraX","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qwerryfiwy%2FNeuraX/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qwerryfiwy%2FNeuraX/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qwerryfiwy%2FNeuraX/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qwerryfiwy","download_url":"https://codeload.github.com/qwerryfiwy/NeuraX/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qwerryfiwy%2FNeuraX/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31571601,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["ai","azureopenai","dotenv","fastapi","framer-motion","nextjs","python","tailwindcss"],"created_at":"2025-06-27T09:02:13.776Z","updated_at":"2026-04-08T20:03:20.284Z","avatar_url":"https://github.com/qwerryfiwy.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"#  NeuraX\n\n\u003e An AI-powered Deep Learning assistant + smart document brain, built for coders and students.\n\n---\n\n##  Overview\n\n**NeuraX** is a smart, domain-specific AI assistant that helps users:\n\n- Understand Deep Learning concepts  \n- Upload PDFs and get instant summaries  \n- Ask contextual questions grounded in your documents  \n\nIt's built with the power of **Azure OpenAI (GPT-4o)** and a blazing fast **FastAPI backend**, combined with a slick **Next.js frontend** styled in TailwindCSS.\n\n---\n\n##  Modules Included\n\n### 1. NeuraX Assistant\nAsk anything related to Deep Learning:  \n- L1 vs L2 regularization  \n- What is vanishing gradient?  \n- CNN vs RNN vs Transformer  \n- Backpropagation, optimizers, activation functions...\n\n NeuraX only answers DL-related queries using prompt control. No off-topic distractions.\n\n---\n\n###  2. NeuraX Docs\nUpload your notes or research papers (`.pdf`) and:\n\n-  Automatically extract and summarize the content  \n-  Ask questions based only on your uploaded doc  \n-  Uses embeddings + FAISS to fetch relevant text chunks  \n\nWorks offline, remembers your doc, and responds fast.\n\n---\n\n## Tech Stack\n\n| Layer       | Tech Used                                                                 |\n|-------------|---------------------------------------------------------------------------|\n| Frontend    | [Next.js](https://nextjs.org/docs), [TailwindCSS](https://tailwindcss.com/docs), [Framer Motion](https://www.framer.com/motion/), [TypeScript](https://www.typescriptlang.org/docs/) |\n| Backend     | [FastAPI](https://fastapi.tiangolo.com/), [Python](https://docs.python.org/3/), [Azure OpenAI GPT-4o](https://learn.microsoft.com/en-us/azure/cognitive-services/openai/overview) |\n| Embedding   | [Azure OpenAI Embeddings](https://learn.microsoft.com/en-us/azure/cognitive-services/openai/how-to/use-embeddings) |\n| Vector DB   | [FAISS](https://github.com/facebookresearch/faiss) + [Pickle](https://docs.python.org/3/library/pickle.html) for local persistence |\n| Security    | [.env-based Key Management](https://12factor.net/config) ([dotenv for Python](https://pypi.org/project/python-dotenv/), [dotenv for Next.js](https://nextjs.org/docs/basic-features/environment-variables)) |\n\n\n---\n\n##  Folder Structure\n\nNeuraX/\n├── frontend/ # Next.js frontend\n│ ├── pages/assistant.tsx\n│ ├── pages/docs.tsx\n│ └── components/\n├── backend/ # FastAPI backend\n│ ├── main.py # Unified backend\n│ ├── vector_db/ # FAISS index + chunk data\n│ └── .env\n\n## API Endpoints\n\n### `POST /ask`\n\u003e Deep Learning assistant\n\n```json\n{\"prompt\": \"Explain dropout in neural nets\"}\n```\n\n### POST /upload-doc\nUpload a PDF and get a summary  \n{\n  \"summary\": \"This paper covers gradient descent and...\"\n}\n\n## Setup Instructions\n\n### Requirements\n\n-Node.js, npm\n-Python 3.9+\n-Azure OpenAI access (GPT-4o + Embedding deployment)\n\n## Frontend\n\n---\n\n##  Setup Instructions\n\n###  Frontend\n\n```bash\ncd frontend\nnpm install\nnpm run dev\n```\n\n### Backend\n```bash\ncd backend\npython -m venv venv\nsource venv/bin/activate  # For Windows: venv\\Scripts\\activate\npip install -r requirements.txt\nAZURE_API_KEY=your-azure-key\nAZURE_OPENAI_ENDPOINT=https://your-resource-name.openai.azure.com/\nuvicorn main:app --reload --port 8001\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqwerryfiwy%2Fneurax","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqwerryfiwy%2Fneurax","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqwerryfiwy%2Fneurax/lists"}