First commit

.gitignore

@@ -0,0 +1,4 @@
+.venv/
+db/
+__pycache__/
+.env

README.MD

@@ -0,0 +1,18 @@
+# Smart Notes
+
+A quite basic small demo using Hugging Face public APIs to summarize notes, extract tags, and detect sentiment.
+It saves everything to a SQLite database, and you can see your recent notes in a basic history page.
+
+Built with Python and Flask. All credit goes to the people who made the models — I’m just calling them.
+
+## Models used
+- facebook/bart-large-cnn (summarization)
+- dslim/bert-base-NER (tags)
+- cardiffnlp/twitter-roberta-base-sentiment (sentiment)
+
+## Notes
+- Works best with English text. Non-English input may not work.
+- Stores notes locally in SQLite; you can view recent notes in a history page.
+
+## Disclaimer
+All credit goes to the teams behind the Hugging Face models. This project is just a small interface for their APIs.

app.py

@@ -0,0 +1,42 @@
+import uuid
+from flask import Flask, render_template, request, session
+from db import init_db, save_history, get_user_history, enforce_history_limit
+from utils import summarize_text, extract_tags, detect_sentiment
+
+app = Flask(__name__)
+app.secret_key = "dev-secret" # creates an ID for session cookies
+init_db()
+
+@app.before_request
+def assign_user_id():
+    if "user_id" not in session:
+        session["user_id"] = str(uuid.uuid4())
+
+@app.route("/", methods=["GET", "POST"])
+def index():
+    summary = tags = sentiment = None
+    if request.method == "POST":
+        text = request.form["text"].strip()
+        if not text:
+            return render_template("index.html", error="Please enter some text.")
+
+        user_id = session["user_id"]
+        enforce_history_limit(user_id)
+
+        summary = summarize_text(text)
+        tags = extract_tags(text)
+        sentiment = detect_sentiment(text)
+
+        save_history(user_id, text, summary, tags, sentiment)
+    
+    print(session)
+    return render_template("index.html", summary=summary, tags=tags, sentiment=sentiment)
+
+@app.route("/history")
+def history():
+    user_id = session.get("user_id")
+    notes = get_user_history(user_id)
+    return render_template("history.html", notes=notes)
+
+if __name__ == "__main__":
+    app.run(debug=True)

db.py

@@ -0,0 +1,68 @@
+import sqlite3
+import os
+from datetime import datetime
+
+DB_PATH = "db/data.db"
+os.makedirs("db", exist_ok=True)
+
+def get_connection():
+    return sqlite3.connect(DB_PATH)
+
+def init_db():
+    conn = get_connection()
+    cur = conn.cursor()
+    cur.execute("""
+        CREATE TABLE IF NOT EXISTS history (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            user_id TEXT NOT NULL,
+            original TEXT,
+            summary TEXT,
+            tags TEXT,
+            sentiment TEXT,
+            created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+        )
+    """)
+    conn.commit()
+    conn.close()
+
+def save_history(user_id, original, summary, tags, sentiment):
+    conn = get_connection()
+    cur = conn.cursor()
+    cur.execute("""
+        INSERT INTO history (user_id, original, summary, tags, sentiment)
+        VALUES (?, ?, ?, ?, ?)
+    """, (user_id, original, summary, tags, sentiment))
+    conn.commit()
+    conn.close()
+
+def get_user_history(user_id, limit=20):
+    conn = get_connection()
+    cur = conn.cursor()
+    cur.execute("""
+        SELECT original, summary, tags, sentiment, created_at
+        FROM history
+        WHERE user_id = ?
+        ORDER BY created_at DESC
+        LIMIT ?
+    """, (user_id, limit))
+    rows = cur.fetchall()
+    conn.close()
+    return rows
+
+def enforce_history_limit(user_id, max_entries=20):
+    conn = get_connection()
+    cur = conn.cursor()
+    cur.execute("SELECT COUNT(*) FROM history WHERE user_id = ?", (user_id,))
+    count = cur.fetchone()[0]
+    if count >= max_entries:
+        to_delete = count - max_entries + 1
+        cur.execute("""
+            DELETE FROM history 
+            WHERE id IN (
+                SELECT id FROM history WHERE user_id = ?
+                ORDER BY created_at ASC
+                LIMIT ?
+            )
+        """, (user_id, to_delete))
+        conn.commit()
+    conn.close()

static/normalize.css

@@ -0,0 +1,379 @@
+/*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */
+
+/* Document
+   ========================================================================== */
+
+/**
+ * 1. Correct the line height in all browsers.
+ * 2. Prevent adjustments of font size after orientation changes in iOS.
+ */
+
+html {
+  line-height: 1.15;
+  /* 1 */
+  -webkit-text-size-adjust: 100%;
+  /* 2 */
+}
+
+/* Sections
+   ========================================================================== */
+
+/**
+ * Remove the margin in all browsers.
+ */
+
+body {
+  margin: 0;
+}
+
+/**
+ * Render the `main` element consistently in IE.
+ */
+
+main {
+  display: block;
+}
+
+/**
+ * Correct the font size and margin on `h1` elements within `section` and
+ * `article` contexts in Chrome, Firefox, and Safari.
+ */
+
+h1 {
+  font-size: 2em;
+  margin: 0.67em 0;
+}
+
+/* Grouping content
+   ========================================================================== */
+
+/**
+ * 1. Add the correct box sizing in Firefox.
+ * 2. Show the overflow in Edge and IE.
+ */
+
+hr {
+  box-sizing: content-box;
+  /* 1 */
+  height: 0;
+  /* 1 */
+  overflow: visible;
+  /* 2 */
+}
+
+/**
+ * 1. Correct the inheritance and scaling of font size in all browsers.
+ * 2. Correct the odd `em` font sizing in all browsers.
+ */
+
+pre {
+  font-family: monospace, monospace;
+  /* 1 */
+  font-size: 1em;
+  /* 2 */
+}
+
+/* Text-level semantics
+   ========================================================================== */
+
+/**
+ * Remove the gray background on active links in IE 10.
+ */
+
+a {
+  background-color: transparent;
+}
+
+/**
+ * 1. Remove the bottom border in Chrome 57-
+ * 2. Add the correct text decoration in Chrome, Edge, IE, Opera, and Safari.
+ */
+
+abbr[title] {
+  border-bottom: none;
+  /* 1 */
+  text-decoration: underline;
+  /* 2 */
+  text-decoration: underline dotted;
+  /* 2 */
+}
+
+/**
+ * Add the correct font weight in Chrome, Edge, and Safari.
+ */
+
+b,
+strong {
+  font-weight: bolder;
+}
+
+/**
+ * 1. Correct the inheritance and scaling of font size in all browsers.
+ * 2. Correct the odd `em` font sizing in all browsers.
+ */
+
+code,
+kbd,
+samp {
+  font-family: monospace, monospace;
+  /* 1 */
+  font-size: 1em;
+  /* 2 */
+}
+
+/**
+ * Add the correct font size in all browsers.
+ */
+
+small {
+  font-size: 80%;
+}
+
+/**
+ * Prevent `sub` and `sup` elements from affecting the line height in
+ * all browsers.
+ */
+
+sub,
+sup {
+  font-size: 75%;
+  line-height: 0;
+  position: relative;
+  vertical-align: baseline;
+}
+
+sub {
+  bottom: -0.25em;
+}
+
+sup {
+  top: -0.5em;
+}
+
+/* Embedded content
+   ========================================================================== */
+
+/**
+ * Remove the border on images inside links in IE 10.
+ */
+
+img {
+  border-style: none;
+}
+
+/* Forms
+   ========================================================================== */
+
+/**
+ * 1. Change the font styles in all browsers.
+ * 2. Remove the margin in Firefox and Safari.
+ */
+
+button,
+input,
+optgroup,
+select,
+textarea {
+  font-family: inherit;
+  /* 1 */
+  font-size: 100%;
+  /* 1 */
+  line-height: 1.15;
+  /* 1 */
+  margin: 0;
+  /* 2 */
+}
+
+/**
+ * Show the overflow in IE.
+ * 1. Show the overflow in Edge.
+ */
+
+button,
+input {
+  /* 1 */
+  overflow: visible;
+}
+
+/**
+ * Remove the inheritance of text transform in Edge, Firefox, and IE.
+ * 1. Remove the inheritance of text transform in Firefox.
+ */
+
+button,
+select {
+  /* 1 */
+  text-transform: none;
+}
+
+/**
+ * Correct the inability to style clickable types in iOS and Safari.
+ */
+
+button,
+[type="button"],
+[type="reset"],
+[type="submit"] {
+  -webkit-appearance: button;
+}
+
+/**
+ * Remove the inner border and padding in Firefox.
+ */
+
+button::-moz-focus-inner,
+[type="button"]::-moz-focus-inner,
+[type="reset"]::-moz-focus-inner,
+[type="submit"]::-moz-focus-inner {
+  border-style: none;
+  padding: 0;
+}
+
+/**
+ * Restore the focus styles unset by the previous rule.
+ */
+
+button:-moz-focusring,
+[type="button"]:-moz-focusring,
+[type="reset"]:-moz-focusring,
+[type="submit"]:-moz-focusring {
+  outline: 1px dotted ButtonText;
+}
+
+/**
+ * Correct the padding in Firefox.
+ */
+
+fieldset {
+  padding: 0.35em 0.75em 0.625em;
+}
+
+/**
+ * 1. Correct the text wrapping in Edge and IE.
+ * 2. Correct the color inheritance from `fieldset` elements in IE.
+ * 3. Remove the padding so developers are not caught out when they zero out
+ *    `fieldset` elements in all browsers.
+ */
+
+legend {
+  box-sizing: border-box;
+  /* 1 */
+  color: inherit;
+  /* 2 */
+  display: table;
+  /* 1 */
+  max-width: 100%;
+  /* 1 */
+  padding: 0;
+  /* 3 */
+  white-space: normal;
+  /* 1 */
+}
+
+/**
+ * Add the correct vertical alignment in Chrome, Firefox, and Opera.
+ */
+
+progress {
+  vertical-align: baseline;
+}
+
+/**
+ * Remove the default vertical scrollbar in IE 10+.
+ */
+
+textarea {
+  overflow: auto;
+}
+
+/**
+ * 1. Add the correct box sizing in IE 10.
+ * 2. Remove the padding in IE 10.
+ */
+
+[type="checkbox"],
+[type="radio"] {
+  box-sizing: border-box;
+  /* 1 */
+  padding: 0;
+  /* 2 */
+}
+
+/**
+ * Correct the cursor style of increment and decrement buttons in Chrome.
+ */
+
+[type="number"]::-webkit-inner-spin-button,
+[type="number"]::-webkit-outer-spin-button {
+  height: auto;
+}
+
+/**
+ * 1. Correct the odd appearance in Chrome and Safari.
+ * 2. Correct the outline style in Safari.
+ */
+
+[type="search"] {
+  -webkit-appearance: textfield;
+  /* 1 */
+  outline-offset: -2px;
+  /* 2 */
+}
+
+/**
+ * Remove the inner padding in Chrome and Safari on macOS.
+ */
+
+[type="search"]::-webkit-search-decoration {
+  -webkit-appearance: none;
+}
+
+/**
+ * 1. Correct the inability to style clickable types in iOS and Safari.
+ * 2. Change font properties to `inherit` in Safari.
+ */
+
+::-webkit-file-upload-button {
+  -webkit-appearance: button;
+  /* 1 */
+  font: inherit;
+  /* 2 */
+}
+
+/* Interactive
+   ========================================================================== */
+
+/*
+ * Add the correct display in Edge, IE 10+, and Firefox.
+ */
+
+details {
+  display: block;
+}
+
+/*
+ * Add the correct display in all browsers.
+ */
+
+summary {
+  display: list-item;
+}
+
+/* Misc
+   ========================================================================== */
+
+/**
+ * Add the correct display in IE 10+.
+ */
+
+template {
+  display: none;
+}
+
+/**
+ * Add the correct display in IE 10.
+ */
+
+[hidden] {
+  display: none;
+}

static/style.css

@@ -0,0 +1,79 @@
+body {
+    box-sizing: border-box;
+    margin: 2rem;
+    font-family: "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;
+    background-color: #f5f5f5;
+    color: #333;
+    line-height: 1.6;
+}
+
+h1 {
+    text-align: center;
+    margin-bottom: 2rem;
+}
+
+form {
+    max-width: 800px;
+    margin: 0 auto;
+}
+
+textarea {
+    width: 100%;
+    min-height: 150px;
+    padding: 0.75rem;
+    border: 1px solid #ccc;
+    border-radius: 5px;
+    font-size: 1rem;
+    resize: vertical;
+}
+
+
+
+button {
+    padding: 0.6rem 1.2rem;
+    background-color: #4a90e2;
+    color: white;
+    border: none;
+    border-radius: 5px;
+    cursor: pointer;
+    font-size: 1rem;
+    margin-top: 1rem;
+}
+
+button:hover {
+    background-color: #357ab8;
+}
+
+
+table {
+    width: 100%;
+    border-collapse: collapse;
+    margin-top: 1.5rem;
+}
+
+th,
+td {
+    border: 1px solid #ccc;
+    padding: 0.75rem;
+    text-align: center;
+}
+
+th {
+    background-color: #4a90e2;
+    color: white;
+}
+
+a {
+    display: inline-block;
+    margin-top: 1rem;
+    text-decoration: none;
+    color: #4a90e2;
+}
+
+a:hover {
+    text-decoration: underline;
+}
+
+.link-wrapper {
+    text-align: center;
+}

templates/history.html

@@ -0,0 +1,46 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>History - Smart Notes</title>
+    <link rel="stylesheet" href="{{ url_for('static', filename='normalize.css') }}">
+    <link rel="stylesheet" href="{{ url_for('static', filename='style.css') }}">
+</head>
+
+<body>
+    <h1>History</h1>
+    <a href="/" class="btn">← Back</a>
+
+    {% if notes %}
+    <table>
+        <thead>
+            <tr>
+                <th>#</th>
+                <th>Original Text</th>
+                <th>Summary</th>
+                <th>Tags</th>
+                <th>Sentiment</th>
+                <th>Created</th>
+            </tr>
+        </thead>
+        <tbody>
+            {% for note in notes %}
+            <tr>
+                <td>{{ loop.index }}</td>
+                <td>{{ note[0][:150] }}{% if note[0]|length > 150 %}...{% endif %}</td>
+                <td>{{ note[1] }}</td>
+                <td>{{ note[2] }}</td>
+                <td>{{ note[3] }}</td>
+                <td>{{ note[4][:19] }}</td>
+            </tr>
+            {% endfor %}
+        </tbody>
+    </table>
+    {% else %}
+    <p>No notes yet. Try creating one!</p>
+    {% endif %}
+</body>
+
+</html>

templates/index.html

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Smart Notes Summarizer</title>
+    <link rel="stylesheet" href="{{ url_for('static', filename='normalize.css') }}">
+    <link rel="stylesheet" href="{{ url_for('static', filename='style.css') }}">
+</head>
+
+<body class="p-4">
+    <h1>Notes Summarizer</h1>
+    <form method="POST">
+        <textarea name="text" rows="8" class="form-control" placeholder="Paste your text here..."></textarea>
+        <button class="btn btn-primary mt-3">Analyze</button>
+    </form>
+
+    {% if summary %}
+    <hr>
+    <h4>Summary:</h4>
+    <p>{{ summary }}</p>
+    <h4>Tags:</h4>
+    <p>{{ tags }}</p>
+    <h4>Sentiment:</h4>
+    <p>{{ sentiment }}</p>
+    {% endif %}
+    <p class="link-wrapper"><a href="{{ url_for('history') }}" class="btn btn-secondary mt-3">View History</a></p>
+</body>
+
+</html>

utils.py

@@ -0,0 +1,85 @@
+import os
+import requests
+from dotenv import load_dotenv
+
+load_dotenv()
+
+HF_API_TOKEN = os.getenv("HF_API_TOKEN")
+SUMMARIZATION_MODEL = "facebook/bart-large-cnn"
+TAGS_MODEL = "dslim/bert-base-NER"
+SENTIMENT_MODEL = "cardiffnlp/twitter-roberta-base-sentiment"
+LABEL_MAP = {"LABEL_0": "Negative", "LABEL_1": "Neutral", "LABEL_2": "Positive"}
+
+ERROR_400_MSG = "Oops! Error 400 — this model might not understand that language. Try using English! If you did, then something went wrong on our end. Sorry x("
+TIMEOUT = 30
+
+def summarize_text(text):
+    headers = {"Authorization": f"Bearer {HF_API_TOKEN}"}
+    payload = {"inputs": text, "parameters": {"min_length": 30, "max_length": 130}}
+    
+    try:
+        resp = requests.post(
+            f"https://api-inference.huggingface.co/models/{SUMMARIZATION_MODEL}",
+            headers=headers,
+            json=payload,
+            timeout=TIMEOUT
+        )
+        resp.raise_for_status()
+        out = resp.json()
+        if isinstance(out, list) and out:
+            return out[0]["summary_text"]
+        return str(out)
+    except requests.exceptions.HTTPError as e:
+        if e.response.status_code == 400:
+            return ERROR_400_MSG
+        return f"Hugging Face API inference failed: {e}"
+
+
+def extract_tags(text):
+    headers = {"Authorization": f"Bearer {HF_API_TOKEN}"}
+    payload = {"inputs": text}
+    
+    try:
+        resp = requests.post(
+            f"https://api-inference.huggingface.co/models/{TAGS_MODEL}",
+            headers=headers,
+            json=payload,
+            timeout=TIMEOUT
+        )
+        resp.raise_for_status()
+        out = resp.json()
+
+        entities = [item.get("word") for item in out if "word" in item]
+        tags = list(set(entities))
+        return ", ".join(tags) if tags else "No tags found."
+    except requests.exceptions.HTTPError as e:
+        if e.response.status_code == 400:
+            return ERROR_400_MSG
+        return f"Hugging Face API inference failed: {e}"
+
+
+
+def detect_sentiment(text):
+    headers = {"Authorization": f"Bearer {HF_API_TOKEN}"}
+    payload = {"inputs": text}
+
+    try:
+        resp = requests.post(
+            f"https://api-inference.huggingface.co/models/{SENTIMENT_MODEL}",
+            headers=headers,
+            json=payload,
+            timeout=TIMEOUT
+        )
+        resp.raise_for_status()
+        out = resp.json()
+
+        if isinstance(out, list) and len(out) > 0:
+            result = out[0] if isinstance(out[0], list) else out
+
+            best = max(result, key=lambda x: x["score"])
+            return LABEL_MAP.get(best["label"], "Unknown")
+        return "Unknown"
+    except requests.exceptions.HTTPError as e:
+        if e.response.status_code == 400:
+            return ERROR_400_MSG
+        return f"Hugging Face API inference failed: {e}"