# Codescraftsman

**Private Data Science Portfolio**

Welcome to the **Codescraftsman** repository! This is a **private personal project** designed as a comprehensive portfolio showcasing Data Science, Machine Learning, and Software Development skills. It includes project pages, analytics dashboards, machine learning models, and a personal chatbot (EthanicBot) using modern AI and Django technologies.

---

## 🌐 Project Structure Overview

```plaintext
codescraftsman/
├── manage.py
├── codescraftsman/
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   ├── wsgi.py
│   ├── asgi.py
├── landing/
│   └── templates/landing/index.html
├── personal/
│   └── templates/personal/
│       ├── index.html
│       ├── bio.html
│       ├── cv.html
│       ├── mission.html
│       ├── vision.html
│       └── values.html
├── analytics/
│   └── templates/analytics/index.html
├── machinelearning/
│   └── templates/machinelearning/index.html
├── services/
│   └── templates/services/index.html
├── testimonials/
│   └── templates/testimonials/index.html
├── about/
│   └── templates/about/index.html
├── ethanicbot/
│   ├── langchain/
│   │   ├── retriever.py
│   │   ├── agent.py
│   │   └── prompt.py
│   └── templates/ethanicbot/chat.html
├── ethanicbot_updater/
├── templates/
│   ├── base.html
│   └── partials/
│       ├── top_nav.html
│       ├── side_nav.html
│       └── footer.html
├── static/
│   ├── css/
│   ├── js/
│   └── img/
└── media/
```

---

## 📈 Features
- **Landing Page:** Professional intro to the portfolio.
- **Personal Section:** Bio, CV, Mission, Vision, Values.
- **Analytics:** Dashboards, Excel cleanup, SQL reporting.
- **Machine Learning:** Models for regression, classification, NLP, and clustering.
- **Services:** Offered services description.
- **Testimonials:** Client testimonials.
- **About:** Project and personal background.
- **EthanicBot:** AI-powered chatbot using LangChain and Hugging Face integrations.
- **Real-time updates:** EthanicBot's background tasks with Celery and Redis.

---

## 🚀 Tech Stack

- **Backend:** Django 4.2
- **Frontend:** HTML5, CSS3, JavaScript
- **AI & ML:** LangChain, Hugging Face Transformers, FAISS, Sentence Transformers, PyTorch
- **Asynchronous Tasks:** Celery + Redis
- **Deployment:** WSGI/ASGI ready

---

## 🖋️ Installation

1. Clone the repository:
   ```bash
   git clone https://gitfront.io/r/Thimethane/ucyPJ4GgME7t/codescraftman.git
   cd codescraftsman
   ```

2. (Optional but recommended) Create a virtual environment:
   ```bash
   python -m venv venv
   source venv/bin/activate  # On Windows use `venv\Scripts\activate`
   ```

3. Install all dependencies:
   ```bash
   pip install -r requirements.txt
   ```

4. Configure your environment variables if necessary.

5. Run migrations:
   ```bash
   python manage.py migrate
   ```

6. Start the development server:
   ```bash
   python manage.py runserver_with_celery
   ```

---

## 📁 Requirements

```
Django>=4.2,<5.0
langchain>=0.2.2
langchain-community>=0.3.21
langchain-huggingface>=0.0.1
faiss-cpu>=1.10.0
numpy==1.26.4
tiktoken>=0.5.1
transformers>=4.37.2
torch>=2.2.0
sentence-transformers>=2.2.2
requests>=2.31.0
celery
redis
python-dotenv
channels
channels-redis
django-celery-beat
django-celery-results
joblib
``` 

---

## 🔍 Notes
- **Private repository**: This portfolio is intended for personal showcasing and is not open-source.
- **Environment Variables:** Remember to configure `.env` for secret keys, Redis URL, database credentials, etc.
- **Chatbot:** EthanicBot uses LangChain agents with local FAISS vectorstore.
- **Async tasks:** Celery is configured for background updates for EthanicBot embeddings.

---

## 🔧 Future Improvements
- Integration with Docker.
- Unit and integration tests.
- Advanced NLP pipelines.
- Deployment to cloud (AWS/GCP/Azure).

---

## 🛍️ License
**This is a private project. All rights reserved.**