🌐 Efeos — Personal Productivity Ecosystem

Your Entire Life, One Ecosystem.

Efeos is an open-source, modular, self-hosted personal productivity ecosystem. Inspired by how Azure DevOps provides developers with integrated tools, Efeos brings the same philosophy to everyday life — notes, knowledge base, budget, mail, AI chat, and cloud storage — all built from scratch, all open source.

Every service is written from the ground up. No forks, no wrappers.

🚀 Live Demo

🔗 View Live Demo

🛠️ Technologies Used

Technology	Purpose
HTML5	Semantic page structure
CSS3	Styling, animations, grid layout, custom properties
JavaScript (Vanilla)	SPA routing, interactivity, dynamic content
Google Fonts	Typography (Sora, JetBrains Mono)
GitHub Pages	Deployment and hosting
ReportLab (Python)	AI Agent Planning Document (PDF)

🏗️ Architecture

┌─────────────────────────────────────────────┐
│  Web Client │ Mobile Client │ Mobile Launcher│
├─────────────────────────────────────────────┤
│   API Gateway + SSO/OAuth2 + AI Agent        │
│              + Event Bus                     │
├──────┬──────┬──────┬──────┬──────┬──────────┤
│ Memo │ Docs │Budgt │ Mail │  AI  │  Vault   │
├──────┴──────┴──────┴──────┴──────┴──────────┤
│   PostgreSQL  │  Redis  │  Object Storage    │
└─────────────────────────────────────────────┘

📦 Core Services

Service	Description	Built From Scratch
Efeos Memo	Quick thought capture & microblog-style notes	✅
Efeos Docs	Knowledge base with bi-directional linking	✅
Efeos Budget	Personal budget & envelope tracking	✅
Efeos Mail	Self-hosted email (SMTP/IMAP)	✅
Efeos AI	AI-powered chat with cross-service awareness	✅
Efeos Vault	File storage & synchronization	✅

📱 Client Platforms

• Web Client — Full-featured browser dashboard
• Mobile Client — Native-like mobile app (iOS/Android)
• Mobile Launcher — Custom Android launcher with Efeos integration

🧑‍💻 Setup & Run

# Clone
git clone https://github.com/efekurucay/efeos.git
cd efeos

# Open directly
open index.html

# Or use a local server
python3 -m http.server 8080
# Visit http://localhost:8080

Deploy to GitHub Pages

1. Push to GitHub
2. Settings → Pages → main branch → / (root)
3. Live at https://efekurucay.github.io/efeos/

📄 AI Agent Planning Document

📎 PDF Version

📁 Project Structure

efeos/
├── index.html                          # Main website (SPA)
├── README.md                           # This file
└── docs/
    └── AI_Agent_Planning_Document.pdf  # AI integration plan

👤 Author

Yahya Efe Kuruçay

• 🎓 Computer Science & Engineering @ Akdeniz University
• 🌐 efekurucay.com
• 💼 LinkedIn
• ⬡ GitHub

Course: 26G_CSE 336_Advanced Web Programming

📝 License

MIT License — free to use, modify, and distribute.