AIxplora - Your AI powered personal file explorer

🖥️ Now available for download 🖥️!

AIxplora is your new personal assistant, an open-source project that opens up unlimited possibilities. It leverages AI and LLMs to understand all types of documents, unrestricted by their length or format.

Imagine being able to query PDF files, MP3 audio, videos, and other types of documents with equal ease and proficiency. Yes, that's the limitless world AIxplora is inviting you into!

🚀 Highlighted Features

Universal File Integration: Accepts any file type without restrictions on length.
Open-Source Transparency: Complete access to the source code, granting unparalleled flexibility and trust.
Flexible Privacy Options:
- Use official OpenAI and ChatGPT models while ensuring data confidentiality.
- Option to utilize open-source models for an added layer of privacy. (Everything will run on your machine, no third party API usage)
Innovative Summarization: Harness a unique approach to transform your files into concise summaries.
Interactive File Indexing: Engage in dynamic conversations with your indexed files, or detach the "AIxplora brain"-interface for a pure ChatGPT experience.

💡 Roadmap

AIxplora-Cloud: Share your knowledge seamlessly, perfect for businesses, friends, or families aiming for collaborative learning.
AIxplora Integration: Embed your AIxplora brain as a Chat-widget on your website, enabling instant AI-backed responses to user queries.
AIxplora Executable: Simplified usage for all; install AIxplora just like any standard application, no technical expertise needed.
Stay Tuned!: More exciting updates are on the horizon.

🎥 Demo video

Electron.-.AIxplora.-.your.personal.file.explorer.assistant.-.20.August.2023.mp4

🛠 How to Run Locally

Clone the Repository & Install Dependencies

git clone git@github.com:grumpyp/aixplora.git

Install Dependencies

pip install -r backend/requirements.txt
cd frontend && npm install
cd ..

Launch the Backend & Frontend

python backend/main.py
cd frontend
npm start

🔍 Troubleshooting: Encountering frontend installation problems? Consult this debugging guide.

🐳 How to Run using Docker Compose

Clone the Repository

git clone git@github.com:grumpyp/aixplora.git

Build Docker Image & Spin Up Containers
```
install=true docker compose up --build
```
Initial Build
- Ensure the frontend/node_modules folder is absent on the first command execution.
- The initial building process might be prolonged due to dependency installation.
Post-Build Notification
- After the build and package installation concludes, an error might appear in the console: app exited with code null, waiting for change to restart it. This is a known issue we're addressing.
Access the UI
- Visit http://localhost:1212/.
Subsequent Launches
```
docker compose up
```
📝 Notes:
- After appending new packages in requirements.txt, execute docker compose up --build.
- Post adding fresh packages in package.json, use install=true docker compose up for new package installations.
- To solely launch the frontend: docker compose up frontend.
- To solely launch the backend: docker compose up backend.

🤝 How Can You Contribute?

With the recent release of a PoC for the project, your involvement is pivotal. Here's how you can be a part of our journey:

Code: Dive deep into our codebase! Whether it's writing, refactoring, or optimizing, every line contributes to our collective vision.
Documentation: Illuminate our project's essence. Assist in crafting clearer and more user-centric guidelines and explanations.
Testing: Become our frontline in quality assurance. Each bug identified is a stride towards unparalleled product excellence.
Suggest Features: Your imagination is our canvas. We deeply value ideas, irrespective of their origin.
Spread the Word: Amplify our message. Introduce AIxplora to your network and watch it evolve and flourish with increased collective insight.

md-abid-hussain/aixplora