{"id":25832484,"url":"https://github.com/esradag/personal-research-assistant","last_synced_at":"2025-07-02T08:34:49.818Z","repository":{"id":279821845,"uuid":"940102452","full_name":"esradag/personal-research-assistant","owner":"esradag","description":"An AI-powered research assistant Python, Streamlit, Google Cloud, LangChain, LangGraph, LlamaIndex, and OpenAI to automate information discovery, verification, synthesis, and structured report generation.","archived":false,"fork":false,"pushed_at":"2025-02-27T16:28:50.000Z","size":43,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-27T22:49:37.098Z","etag":null,"topics":["googlecloud","langchain","langgraph","llamaindex","openai","python","streamlit"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/esradag.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-02-27T16:08:59.000Z","updated_at":"2025-02-27T16:36:10.000Z","dependencies_parsed_at":"2025-02-27T22:50:31.633Z","dependency_job_id":"a5be723a-b6b5-473f-9938-efcb991a3a28","html_url":"https://github.com/esradag/personal-research-assistant","commit_stats":null,"previous_names":["esradag/personal-research-assistant"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esradag%2Fpersonal-research-assistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esradag%2Fpersonal-research-assistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esradag%2Fpersonal-research-assistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/esradag%2Fpersonal-research-assistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/esradag","download_url":"https://codeload.github.com/esradag/personal-research-assistant/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241245454,"owners_count":19933295,"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":["googlecloud","langchain","langgraph","llamaindex","openai","python","streamlit"],"created_at":"2025-02-28T21:39:38.129Z","updated_at":"2025-02-28T21:39:38.679Z","avatar_url":"https://github.com/esradag.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Personal Research Assistant\n\nAn AI-powered research assistant designed for efficient information discovery, collection, verification, and synthesis.\n\n## Features\n\n- **Topic Discovery**: Expand and refine research topics to ensure comprehensive coverage.\n- **Information Collection**: Retrieve content from multiple sources, including the web, Wikipedia, and academic databases.\n- **Verification**: Cross-check information from different sources for reliability and accuracy.\n- **Synthesis**: Analyze and integrate collected data to generate meaningful insights.\n- **Reporting**: Generate well-structured research reports with proper citations.\n\n## Technology Stack\n\n- **Python**: Core programming language.\n- **Streamlit**: Provides a user-friendly interface for topic input, scope selection, and result visualization.\n- **Google Cloud**: Utilizes Document AI for document analysis and Cloud Storage for research data.\n- **LangChain**: Manages research pipelines, integrating tools like Google Search, Wikipedia, and academic databases.\n- **LangGraph**: Implements a state graph to manage research flow (topic discovery → data collection → verification → synthesis → reporting).\n- **LlamaIndex**: Enables efficient indexing of research sources for quick querying.\n- **OpenAI**: Powers language models for research understanding, summarization, and coherent report generation.\n\n## Installation\n\n### 1. Clone the Repository\n```bash\ngit clone https://github.com/yourusername/personal-research-assistant.git\ncd personal-research-assistant\n```\n\n### 2. Create and Activate a Virtual Environment\n```bash\npython -m venv venv\nsource venv/bin/activate  # On Windows, use: venv\\Scripts\\activate\n```\n\n### 3. Install Dependencies\n```bash\npip install -r requirements.txt\n```\n\n### 4. Set Up Environment Variables\nCreate a `.env` file and add the following configurations:\n```\nOPENAI_API_KEY=your_openai_api_key\nGOOGLE_APPLICATION_CREDENTIALS=path_to_your_google_credentials.json\nGOOGLE_SEARCH_API_KEY=your_google_search_api_key\n```\n\n## Usage\n\n### 1. Run the Application\n```bash\nstreamlit run app.py\n```\n\n### 2. Access the Interface\nOpen your web browser and navigate to:  \n`http://localhost:8501`\n\n### 3. Start Researching\n- Enter your research topic.\n- Define the scope and parameters.\n- Initiate the research process.\n\n### 4. Explore and Download Results\n- View collected information.\n- Analyze findings.\n- Download the generated research report.\n\n## Configuration\n\nCustomize the research assistant by modifying the settings in `config.py`:\n\n- Adjust OpenAI model parameters.\n- Configure search depth and scope.\n- Define preferred academic databases.\n- Customize report formatting options.\n\n## Contributing\n\nWe welcome contributions! Feel free to submit a pull request to enhance the project.\n\n## License\n\nThis project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) License.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesradag%2Fpersonal-research-assistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fesradag%2Fpersonal-research-assistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesradag%2Fpersonal-research-assistant/lists"}