postcraftin 2.0.1__tar.gz

postcraftin-2.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Emre Duelger
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

postcraftin-2.0.1/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: postcraftin
+Version: 2.0.1
+Requires-Python: >=3.10
+License-File: LICENSE
+Requires-Dist: requests>=2.31
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: python-semantic-release>=10.0; extra == "dev"
+Dynamic: license-file

postcraftin-2.0.1/README.md

@@ -0,0 +1,2 @@
+# postcraft
+🤖 AI-powered LinkedIn post generator using local LLMs via Ollama. Personalized ghostwriter with onboarding profile, Few-Shot prompting, and CLI interface.

postcraftin-2.0.1/postcraftin/cli.py

@@ -0,0 +1,65 @@
+import click
+from rich.console import Console
+from rich.table import Table
+
+from postcraftin.config import DEFAULT_MODEL
+from postcraftin.generator import generate_post
+from postcraftin.onboarding import run_onboarding
+from postcraftin.profile import list_profiles, load_profile, get_default_profile_name
+
+console = Console()
+
+
+@click.group()
+def cli():
+    """Postcraftin — AI-powered LinkedIn post generator."""
+    pass
+
+
+@cli.command()
+@click.option("--name", default="default", show_default=True, help="Profile name to create.")
+def onboard(name: str):
+    """Run the interactive onboarding wizard to create a profile."""
+    run_onboarding(name)
+
+
+@cli.command()
+@click.option("-t", "--topic", required=True, help="Topic for the LinkedIn post.")
+@click.option("--length", "-l", "post_length", default="mittel",
+              type=click.Choice(["kurz", "mittel", "lang"], case_sensitive=False),
+              help="Post length: kurz (150-500 Zeichen), mittel (1.200-1.500 Zeichen), lang (1.900-2.500 Zeichen).")
+@click.option("--profile", default=None, help="Profile name to use (default: first available).")
+@click.option("--model", default=DEFAULT_MODEL, show_default=True, help="Ollama model to use.")
+def generate(topic: str, post_length: str, profile: str | None, model: str):
+    """Generate a LinkedIn post for a given topic."""
+    profile_name = profile or get_default_profile_name()
+    if not profile_name:
+        console.print("[red]No profile found. Run 'postcraftin onboard' first.[/red]")
+        raise SystemExit(1)
+    try:
+        profile_data = load_profile(profile_name)
+    except FileNotFoundError as e:
+        console.print(f"[red]{e}[/red]")
+        raise SystemExit(1)
+
+    console.print(f"[cyan]Generating post about:[/cyan] {topic}")
+    console.print(f"[dim]Profile: {profile_name} | Model: {model} | Length: {post_length}[/dim]\n")
+    generate_post(topic, profile_data, post_length=post_length, model=model)
+
+
+@cli.command(name="list-profiles")
+def list_profiles_cmd():
+    """List all available profiles."""
+    profiles = list_profiles()
+    if not profiles:
+        console.print("[yellow]No profiles found. Run 'postcraftin onboard' to create one.[/yellow]")
+        return
+    table = Table(title="postcraftin Profiles")
+    table.add_column("Name", style="cyan")
+    for p in profiles:
+        table.add_row(p)
+    console.print(table)
+
+
+if __name__ == "__main__":
+    cli()

postcraftin-2.0.1/postcraftin/config.py

@@ -0,0 +1,2 @@
+OLLAMA_HOST = "http://localhost:11434"
+DEFAULT_MODEL = "qwen3.5:2b"

postcraftin-2.0.1/postcraftin/generator.py

@@ -0,0 +1,82 @@
+import json
+import requests
+from postcraftin.config import OLLAMA_HOST, DEFAULT_MODEL
+
+POST_LENGTHS = {
+    "kurz": {
+        "zeichen": "150-500",
+        "woerter": "25-85",
+        "beschreibung": "Kurzer Post für schnelle Insights und Umfragen"
+    },
+    "mittel": {
+        "zeichen": "1.200-1.500",
+        "woerter": "200-260",
+        "beschreibung": "Optimaler Bereich für höchstes Engagement"
+    },
+    "lang": {
+        "zeichen": "1.900-2.500",
+        "woerter": "320-425",
+        "beschreibung": "Tiefergehende Analysen und Case Studies"
+    }
+}
+
+
+def _build_few_shot_block(profile: dict) -> str:
+    examples = profile.get("example_posts", [])
+    if not examples:
+        return ""
+    block = "\n\nHier sind Beispiele meines Schreibstils:\n"
+    for i, ex in enumerate(examples, 1):
+        block += f"\n--- Beispiel {i} ---\n{ex}\n"
+    return block
+
+
+SYSTEM_PROMPT = (
+    "Du bist ein professioneller LinkedIn-Content-Schreiber.\n"
+    "- Antworte ausschließlich auf Deutsch.\n"
+    "- Verwende KEINE Emojis, Emoticons oder Unicode-Symbole (wie ✨, 🚀, 💡, etc.).\n"
+    "- Verwende keine englischen Begriffe oder Sätze.\n"
+    "- Achte auf korrekte Rechtschreibung und Grammatik.\n"
+    "- Schreibe in einem professionellen, seriösen Ton."
+)
+
+
+def build_prompt(topic: str, profile: dict, post_length: str = "mittel") -> str:
+    role = profile.get("role", "Experte")
+    audience = profile.get("audience", "Fachleute auf LinkedIn")
+    tonality = profile.get("tonality", "inspirierend")
+    keywords = ", ".join(profile.get("keywords", []))
+    few_shot = _build_few_shot_block(profile)
+    length_info = POST_LENGTHS.get(post_length.lower(), POST_LENGTHS["mittel"])
+
+    prompt = (
+        f"{SYSTEM_PROMPT}\n\n"
+        f"Ich bin {role} und schreibe für {audience}.\n"
+        f"Mein Tonfall ist: {tonality}.\n"
+        f"Relevante Keywords: {keywords}.\n"
+        f"{few_shot}\n\n"
+        f"Schreibe jetzt einen professionellen LinkedIn-Post über das folgende Thema:\n"
+        f"{topic}\n\n"
+        f"Der Post soll ca. {length_info['zeichen']} Zeichen ({length_info['woerter']} Wörter) umfassen.\n"
+        f"Er soll einen starken Hook in den ersten 210 Zeichen haben, klare Absätze und mit einem "
+        f"Call-to-Action enden."
+    )
+    return prompt
+
+
+def generate_post(topic: str, profile: dict, post_length: str = "mittel", model: str = DEFAULT_MODEL) -> None:
+    user_prompt = build_prompt(topic, profile, post_length)
+    payload = {
+        "model": model,
+        "system": SYSTEM_PROMPT,
+        "prompt": user_prompt,
+        "stream": True,
+    }
+    url = f"{OLLAMA_HOST}/api/generate"
+    with requests.post(url, json=payload, stream=True, timeout=120) as resp:
+        resp.raise_for_status()
+        for line in resp.iter_lines():
+            if line:
+                chunk = json.loads(line)
+                print(chunk.get("response", ""), end="", flush=True)
+    print()

postcraftin-2.0.1/postcraftin/onboarding.py

@@ -0,0 +1,58 @@
+import click
+from postcraftin.profile import save_profile
+
+
+def run_onboarding(profile_name: str) -> None:
+    click.echo(click.style("\n🚀 Willkommen bei postcraftin Onboarding!", fg="cyan", bold=True))
+    click.echo("Beantworte 5 kurze Fragen, um dein Profil zu erstellen.\n")
+
+    # Schritt 1: Branche / Rolle
+    click.echo(click.style("Schritt 1/5: Branche & Rolle", fg="yellow", bold=True))
+    role = click.prompt("In welcher Branche/Rolle bist du tätig?", default="Software Engineer")
+
+    # Schritt 2: Zielgruppe
+    click.echo(click.style("\nSchritt 2/5: Zielgruppe", fg="yellow", bold=True))
+    audience = click.prompt("Wen möchtest du mit deinen Posts erreichen?", default="Tech-Professionals auf LinkedIn")
+
+    # Schritt 3: Tonality
+    click.echo(click.style("\nSchritt 3/5: Tonality", fg="yellow", bold=True))
+    tonality_choice = click.prompt(
+        "Welchen Tonfall bevorzugst du?",
+        type=click.Choice(["inspirierend", "sachlich", "provokativ"], case_sensitive=False),
+        default="inspirierend",
+    )
+
+    # Schritt 4: Themen-Keywords
+    click.echo(click.style("\nSchritt 4/5: Themen-Keywords", fg="yellow", bold=True))
+    keywords_raw = click.prompt(
+        "Nenne deine wichtigsten Themen-Keywords (kommagetrennt)",
+        default="KI, Daten, Architektur",
+    )
+    keywords = [k.strip() for k in keywords_raw.split(",") if k.strip()]
+
+    # Schritt 5: Beispiel-Posts
+    click.echo(click.style("\nSchritt 5/5: Beispiel-Posts zur Stil-Kalibrierung", fg="yellow", bold=True))
+    click.echo("Füge 2 Beispiel-Posts ein, die deinen Stil widerspiegeln.")
+    click.echo("(Beende jeden Post mit einer Leerzeile + ENTER + 'END')")
+
+    example_posts = []
+    for i in range(1, 3):
+        click.echo(click.style(f"\nBeispiel-Post {i}:", fg="green"))
+        lines = []
+        while True:
+            line = input()
+            if line.strip().upper() == "END":
+                break
+            lines.append(line)
+        example_posts.append("\n".join(lines).strip())
+
+    profile_data = {
+        "role": role,
+        "audience": audience,
+        "tonality": tonality_choice,
+        "keywords": keywords,
+        "example_posts": example_posts,
+    }
+
+    save_profile(profile_name, profile_data)
+    click.echo(click.style(f"\n✅ Profil '{profile_name}' wurde gespeichert!", fg="green", bold=True))

postcraftin-2.0.1/postcraftin/profile.py

@@ -0,0 +1,33 @@
+import json
+from pathlib import Path
+
+PROFILES_DIR = Path.home() / ".postcraftin" / "profiles"
+
+
+def _ensure_dir() -> None:
+    PROFILES_DIR.mkdir(parents=True, exist_ok=True)
+
+
+def save_profile(name: str, data: dict) -> None:
+    _ensure_dir()
+    path = PROFILES_DIR / f"{name}.json"
+    with open(path, "w", encoding="utf-8") as f:
+        json.dump(data, f, indent=2, ensure_ascii=False)
+
+
+def load_profile(name: str) -> dict:
+    path = PROFILES_DIR / f"{name}.json"
+    if not path.exists():
+        raise FileNotFoundError(f"Profile '{name}' not found at {path}")
+    with open(path, "r", encoding="utf-8") as f:
+        return json.load(f)
+
+
+def list_profiles() -> list[str]:
+    _ensure_dir()
+    return [p.stem for p in PROFILES_DIR.glob("*.json")]
+
+
+def get_default_profile_name() -> str | None:
+    profiles = list_profiles()
+    return profiles[0] if profiles else None

postcraftin-2.0.1/postcraftin.egg-info/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: postcraftin
+Version: 2.0.1
+Requires-Python: >=3.10
+License-File: LICENSE
+Requires-Dist: requests>=2.31
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: python-semantic-release>=10.0; extra == "dev"
+Dynamic: license-file

postcraftin-2.0.1/postcraftin.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+postcraftin/__init__.py
+postcraftin/cli.py
+postcraftin/config.py
+postcraftin/generator.py
+postcraftin/onboarding.py
+postcraftin/profile.py
+postcraftin.egg-info/PKG-INFO
+postcraftin.egg-info/SOURCES.txt
+postcraftin.egg-info/dependency_links.txt
+postcraftin.egg-info/entry_points.txt
+postcraftin.egg-info/requires.txt
+postcraftin.egg-info/top_level.txt
+tests/test_smoke.py

postcraftin-2.0.1/postcraftin.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

postcraftin-2.0.1/postcraftin.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+postcraftin = postcraftin.cli:cli

postcraftin-2.0.1/postcraftin.egg-info/requires.txt

@@ -0,0 +1,8 @@
+requests>=2.31
+click>=8.1
+rich>=13.0
+
+[dev]
+pytest
+ruff
+python-semantic-release>=10.0

postcraftin-2.0.1/postcraftin.egg-info/top_level.txt

@@ -0,0 +1 @@
+postcraftin

postcraftin-2.0.1/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "postcraftin"
+version = "2.0.1"
+requires-python = ">=3.10"
+dependencies = [
+    "requests>=2.31",
+    "click>=8.1",
+    "rich>=13.0",
+    ]
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "ruff",
+    "python-semantic-release>=10.0",
+]
+
+[tool.semantic_release]
+version_toml = ["pyproject.toml:project.version"]
+tag_format = "v{version}"
+major_on_zero = false
+
+[tool.semantic_release.branches.main]
+match = "(main|master)"
+prerelease = false
+
+[tool.semantic_release.commit_parser_options]
+allowed_tags = ["feat", "fix", "perf", "refactor", "style", "test", "docs", "build", "ci", "chore"]
+minor_tags = ["feat"]
+patch_tags = ["fix", "perf"]
+
+[project.scripts]
+postcraftin = "postcraftin.cli:cli"
+
+[tool.ruff]
+line-length = 120
+exclude = [".venv", "build", "dist", "*.egg-info", ".pytest_cache"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "D", "C90", "UP036"]
+ignore = ["E203", "D100", "D101", "D102", "D103", "D104", "D403", "I001"]
+
+[tool.setuptools.packages.find]
+include = ["postcraftin*"]

postcraftin-2.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

postcraftin-2.0.1/tests/test_smoke.py

@@ -0,0 +1,26 @@
+"""Smoke tests for postcraftin core functionality."""
+
+from postcraftin.config import OLLAMA_HOST, DEFAULT_MODEL
+from postcraftin.generator import build_prompt
+
+
+def test_config_defaults():
+    """OLLAMA_HOST and DEFAULT_MODEL must be set to non-empty strings."""
+    assert OLLAMA_HOST, "OLLAMA_HOST should not be empty"
+    assert DEFAULT_MODEL, "DEFAULT_MODEL should not be empty"
+    assert OLLAMA_HOST.startswith("http"), "OLLAMA_HOST should be an HTTP URL"
+
+
+def test_build_prompt_contains_profile_fields():
+    """build_prompt() output must contain the topic and key profile fields."""
+    topic = "AI in data pipelines"
+    profile = {
+        "role": "Data Engineer",
+        "audience": "Fachleute auf LinkedIn",
+        "tonality": "professional",
+        "keywords": ["AI", "data"],
+    }
+    result = build_prompt(topic, profile)
+    assert topic in result
+    assert profile["role"] in result
+    assert profile["tonality"] in result