{"id":28418660,"url":"https://github.com/efe-eroglu/syllexa-ai-agent","last_synced_at":"2026-04-16T08:38:12.018Z","repository":{"id":294512584,"uuid":"948899164","full_name":"Efe-Eroglu/syllexa-ai-agent","owner":"Efe-Eroglu","description":"An AI assistant specially designed for dyslexic users, supporting both voice and text queries.","archived":false,"fork":false,"pushed_at":"2025-06-16T13:09:34.000Z","size":5465,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-28T04:35:16.273Z","etag":null,"topics":["ai","ai-agent","ai-assistant","dyslexia","fastapi","llm","rag","retrieval-augmented-generation","stt","tts"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/Efe-Eroglu.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,"zenodo":null}},"created_at":"2025-03-15T07:55:25.000Z","updated_at":"2025-06-16T13:09:38.000Z","dependencies_parsed_at":"2025-06-16T13:45:40.042Z","dependency_job_id":"ac9f5613-ba3a-4026-b7f3-b57d08508e34","html_url":"https://github.com/Efe-Eroglu/syllexa-ai-agent","commit_stats":null,"previous_names":["efe-eroglu/syllexa-ai-agent"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Efe-Eroglu/syllexa-ai-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Efe-Eroglu%2Fsyllexa-ai-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Efe-Eroglu%2Fsyllexa-ai-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Efe-Eroglu%2Fsyllexa-ai-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Efe-Eroglu%2Fsyllexa-ai-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Efe-Eroglu","download_url":"https://codeload.github.com/Efe-Eroglu/syllexa-ai-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Efe-Eroglu%2Fsyllexa-ai-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31878505,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T07:36:03.521Z","status":"ssl_error","status_checked_at":"2026-04-16T07:35:53.576Z","response_time":69,"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","ai-agent","ai-assistant","dyslexia","fastapi","llm","rag","retrieval-augmented-generation","stt","tts"],"created_at":"2025-06-04T11:40:49.498Z","updated_at":"2026-04-16T08:38:12.013Z","avatar_url":"https://github.com/Efe-Eroglu.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\r\n  \u003ch1\u003e🧠 Syllexa AI\u003c/h1\u003e\r\n  \u003cp\u003e\r\n    \u003cstrong\u003e- Disleksi dostu yapay zeka asistanı - \u003c/strong\u003e\u003cbr\u003e\r\n    \u003cem\u003e- Dyslexia-friendly AI assistant -\u003c/em\u003e\r\n  \u003c/p\u003e\r\n\u003c/div\u003e\r\n\r\n## 📋 İçerik / Contents\r\n\r\n- [🚀 Proje Hakkında / About](#-proje-hakkında--about)\r\n- [✨ Özellikler / Features](#-özellikler--features)\r\n- [💻 Teknolojiler / Technologies](#-teknolojiler--technologies)\r\n- [🏗️ Mimari / Architecture](#️-mimari--architecture)\r\n- [🔧 Kurulum / Installation](#-kurulum--installation)\r\n- [🖥️ Kullanım / Usage](#️-kullanım--usage)\r\n- [👥 Katkıda Bulunma / Contributing](#-katkıda-bulunma--contributing)\r\n- [📄 Lisans / License](#-lisans--license)\r\n\r\n## 🚀 Proje Hakkında / About\r\n\r\nSyllexa AI, disleksi rahatsızlığı olan kullanıcılar için özel olarak tasarlanmış, konuşma ve metin iletişimini destekleyen kapsamlı bir dijital asistan uygulamasıdır. Disleksi hastalarının konuşmalarındaki bozuklukları düzeltmeye ve günlük iletişimlerini kolaylaştırmaya yardımcı olur. Kullanıcılar asistanla sesli olarak birebir konuşabilir, metin tabanlı sohbet edebilir, ayrıca belge yükleyerek bu belgeler üzerinden sorular sorabilirler. RAG (Retrieval Augmented Generation) teknolojisi sayesinde hem disleksi dostu iletişim hem de belge tabanlı bilgi erişimi sağlanmaktadır.\r\n\r\n*Syllexa AI is a comprehensive digital assistant application specially designed for users with dyslexia, supporting both speech and text communication. It helps correct speech abnormalities in dyslexic users and facilitates their daily communication. Users can have one-on-one voice conversations with the assistant, engage in text-based chat, and also upload documents to ask questions about them. Thanks to RAG (Retrieval Augmented Generation) technology, both dyslexia-friendly communication and document-based information access are provided.*\r\n\r\n## ✨ Özellikler / Features\r\n\r\n- 🎙️ **Sesli İletişim / Voice Communication**: Birebir sesli konuşma desteği (voice-to-voice)\r\n- 💬 **Disleksi Dostu Sohbet / Dyslexia-Friendly Chat**: Konuşma ve yazım bozukluklarını düzelten özel eğitimli model\r\n- 📑 **Doküman İşleme / Document Processing**: PDF, DOCX ve TXT formatlarını destekler\r\n- 🔍 **Bağlam Tabanlı Yanıtlar / Context-Based Answers**: RAG teknolojisi ile dokümanlardan ilgili bilgileri çıkarır\r\n- 🧠 **Hafıza / Contextual Memory**: Her sohbet için önceki konuşmaları hatırlar ve bağlamı korur\r\n- 🗣️ **Çoklu İletişim Modları / Multiple Communication Modes**: Ses-ses (voice-to-voice), metin-metin (text-to-text), metin-ses (text-to-voice), ses-metin (voice-to-text)\r\n- 🌐 **Çoklu Dil Desteği / Multi-language Support**: Türkçe ve İngilizce\r\n- 🔐 **Güvenli Giriş / Secure Login**: JWT, Google ve Facebook ile giriş seçenekleri\r\n- 👁️ **Disleksi Dostu Arayüz / Dyslexia-Friendly Interface**: Kullanıcı deneyimini iyileştirmek için özel tasarlanmış UI\r\n\r\n## 💻 Teknolojiler / Technologies\r\n\r\n### Backend\r\n\r\n- **Framework**: FastAPI\r\n- **Veritabanı / Database**: PostgreSQL\r\n- **AI Servisleri / AI Services**: OpenAI API, LangChain\r\n- **Vektör Veritabanı / Vector Database**: ChromaDB\r\n- **Doküman İşleme / Document Processing**: PyPDF, Python-docx\r\n- **Kimlik Doğrulama / Authentication**: JWT, OAuth2\r\n\r\n### Frontend\r\n\r\n- **Framework**: React (v19)\r\n- **Yapı Aracı / Build Tool**: Vite\r\n- **UI Kütüphaneleri / UI Libraries**: Material UI, Tailwind CSS, Bootstrap\r\n- **API İletişimi / API Communication**: Axios\r\n- **Routing**: React Router\r\n- **Ses İşleme / Audio Processing**: Recorder-js\r\n\r\n## 🏗️ Mimari / Architecture\r\n\r\n### RAG İş Akışı / RAG Workflow\r\n\r\n```mermaid\r\ngraph TD\r\n    A[Doküman Yükleme / Document Upload] --\u003e B[Metin Çıkarma / Text Extraction]\r\n    B --\u003e C[Bölme \u0026 Vektörleştirme / Chunking \u0026 Vectorization]\r\n    C --\u003e D[ChromaDB Vektör Depolama / Vector Storage]\r\n    E[Kullanıcı Sorusu / User Query] --\u003e F[Soru Vektörleştirme / Query Vectorization]\r\n    F --\u003e G[Benzer Doküman Parçaları Bulma / Find Similar Chunks]\r\n    G --\u003e H[Bağlam Oluşturma / Context Creation]\r\n    H --\u003e I[OpenAI API ile Yanıt Üretme / Generate Answer]\r\n    I --\u003e J[Kullanıcıya Yanıt / Response to User]\r\n```\r\n\r\n### Sistem Mimarisi / System Architecture\r\n\r\n```\r\n📁 backend/\r\n  ├── 📁 app/\r\n  │   ├── 📁 api/\r\n  │   │   ├── 📁 routes/\r\n  │   │   │   ├── 📄 auth_routes.py      # Kimlik doğrulama rotaları\r\n  │   │   │   ├── 📄 chat_routes.py      # Sohbet ve RAG rotaları\r\n  │   │   │   └── 📄 user_routes.py      # Kullanıcı yönetimi rotaları\r\n  │   ├── 📁 core/\r\n  │   │   ├── 📄 config.py               # Uygulama yapılandırması ve API anahtarları\r\n  │   │   ├── 📄 security.py             # JWT işlemleri\r\n  │   │   ├── 📁 db/\r\n  │   │   │   ├── 📄 models.py               # Veritabanı modelleri\r\n  │   │   │   ├── 📄 database.py             # Veritabanı bağlantısı\r\n  │   │   │   └── 📄 queries.py              # Veritabanı sorguları\r\n  │   ├── 📁 services/\r\n  │   │   ├── 📄 openai_service.py       # OpenAI API entegrasyonu\r\n  │   │   ├── 📄 rag_service.py          # RAG işleme servisi\r\n  │   │   └── 📄 document_processor.py     # Doküman işleme yardımcıları\r\n  │   ├── 📁 utils/\r\n  │   │   └── 📄 main.py                     # Ana FastAPI uygulaması\r\n  └── 📄 .requirements.txt               # Bağımlılıklar\r\n\r\n📁 frontend/\r\n  ├── 📁 src/\r\n  │   ├── 📁 components/                 # UI bileşenleri\r\n  │   ├── 📁 pages/                      # Sayfa bileşenleri\r\n  │   ├── 📁 context/                    # React context sağlayıcıları\r\n  │   ├── 📁 services/                   # API iletişim servisleri\r\n  │   ├── 📁 utils/                      # Yardımcı fonksiyonlar\r\n  │   └── 📄 App.jsx                     # Ana React uygulaması\r\n```\r\n\r\n## 🔧 Kurulum / Installation\r\n\r\n### Ön Koşullar / Prerequisites\r\n\r\n- Python 3.9+\r\n- PostgreSQL\r\n- OpenAI API Anahtarı / API Key\r\n\r\n### Backend Kurulumu / Backend Setup\r\n\r\n```bash\r\n# Repo'yu klonla / Clone repository\r\ngit clone https://github.com/Efe-Eroglu/syllexa-ai-agent.git\r\ncd syllexa-ai-agent/backend\r\n\r\n# Sanal ortam oluştur / Create virtual environment\r\npython -m venv venv\r\nsource venv/bin/activate  # Linux/Mac\r\nvenv\\Scripts\\activate  # Windows\r\n\r\n# Bağımlılıkları yükle / Install dependencies\r\npip install -r .requirements.txt\r\n\r\n# .env dosyasını oluştur / Create .env file\r\ncp sample.env .env\r\n# .env dosyasını düzenle / Edit .env file\r\n\r\n# Sunucuyu başlat / Start server\r\nuvicorn app.main:app --reload\r\n```\r\n\r\n### Frontend Kurulumu / Frontend Setup\r\n\r\n```bash\r\n# Frontend dizinine git / Go to frontend directory\r\ncd frontend\r\n\r\n# Geliştirme sunucusunu başlat / Start development server\r\nnpm run dev\r\n```\r\n\r\n## 🖥️ Kullanım / Usage\r\n\r\n1. Hesap oluşturun veya giriş yapın / Create an account or log in\r\n2. Ana sayfadan \"Yeni Sohbet\" seçeneğini tıklayın / Click \"New Chat\" on the home page\r\n3. Tercih ettiğiniz iletişim modunu seçin (sesli veya yazılı) / Choose your preferred communication mode (voice or text)\r\n4. Disleksi asistanıyla doğrudan konuşun veya yazışın / Talk or text directly with the dyslexia assistant\r\n5. Doküman yükleyebilir ve belgeleriniz hakkında sorular sorabilirsiniz / Optionally upload documents and ask questions about them\r\n6. Sesli iletişim için mikrofon simgesini kullanın / Use microphone icon for voice interaction\r\n\r\n### İletişim Modları / Communication Modes\r\n\r\n- **Ses-Ses (Voice-to-Voice)**: Asistanla doğrudan konuşun ve sesli yanıt alın\r\n- **Metin-Metin (Text-to-Text)**: Yazılı olarak sorun ve yazılı yanıt alın\r\n- **Ses-Metin (Voice-to-Text)**: Konuşarak sorun ve yazılı yanıt alın\r\n- **Metin-Ses (Text-to-Voice)**: Yazılı olarak sorun ve sesli yanıt alın\r\n\r\n### Ek Özellikler / Additional Features\r\n\r\n- **Disleksi Düzeltme / Dyslexia Correction**: Konuşma ve yazım hatalarını otomatik düzeltme\r\n- **Doküman Yönetimi / Document Management**: Daha önce yüklenen dokümanları görüntüleyin ve yönetin\r\n- **Sohbet Geçmişi / Chat History**: Önceki sohbetlerinize erişin\r\n- **Kullanıcı Ayarları / User Settings**: Arayüz görünümünü ve disleksi ayarlarını özelleştirin\r\n\r\n## 👥 Katkıda Bulunma / Contributing\r\n\r\nKatkılarınızı memnuniyetle karşılıyoruz! Lütfen bir Pull Request açın veya önerileriniz için bir Issue oluşturun.\r\n\r\n*Contributions are welcome! Please open a Pull Request or create an Issue for your suggestions.*\r\n\r\n## 📄 Lisans / License\r\n\r\nBu proje MIT lisansı altında lisanslanmıştır. Detaylar için [LICENSE](LICENSE) dosyasına bakın.\r\n\r\n*This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.*\r\n\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fefe-eroglu%2Fsyllexa-ai-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fefe-eroglu%2Fsyllexa-ai-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fefe-eroglu%2Fsyllexa-ai-agent/lists"}