social-duo 0.1.0

package/README.md

@@ -0,0 +1,118 @@
+# social-duo
+
+A production-quality Python CLI where two AI agents collaborate to draft, critique, revise, and reply to social media content. The tool maintains a local workspace with config, history, and exports.
+
+**Highlights**
+- Two agents: Writer and Editor/Responder
+- Iterative loop with PASS/FAIL gating
+- Platform constraints and brand voice
+- SQLite history with export
+- JSON and rich CLI output
+
+## Install
+
+```bash
+cd social-duo
+python -m venv .venv
+source .venv/bin/activate
+pip install -e .
+```
+
+Or with `pipx`:
+
+```bash
+pipx install -e .
+```
+
+## Setup
+
+```bash
+cp .env.example .env
+export OPENAI_API_KEY=your_key_here
+# Optional
+export OPENAI_BASE_URL=https://api.openai.com/v1
+export OPENAI_MODEL=gpt-4o-mini
+```
+
+Initialize the workspace:
+
+```bash
+social_duo init
+```
+
+## Examples
+
+LinkedIn post about agentic workflows:
+
+```bash
+social_duo post --platform linkedin --goal educate --topic "agentic workflows" --audience "engineering leaders" --tone "confident" --length medium
+```
+
+X thread of 5 tweets about vector databases for semantic search:
+
+```bash
+social_duo post --platform x --thread 5 --goal educate --topic "vector databases for semantic search" --audience "ML engineers" --tone technical --length short
+```
+
+Replies to a critical comment (polite + direct):
+
+```bash
+social_duo reply --text "This feels like vaporware." --platform x --style polite --stance neutral
+social_duo reply --text "This feels like vaporware." --platform x --style direct --stance disagree
+```
+
+Autonomous discuss mode (no topic provided):
+
+```bash
+social_duo discuss --platform x --turns 10 --verbose
+```
+
+MOLTBOOK-LITE simulation:
+
+```bash
+social_duo molt run --turns 25
+social_duo molt watch --run-id <id>
+social_duo molt export --run-id <id> --format md
+```
+
+Resume session via history and chat:
+
+```bash
+social_duo history --list
+social_duo history --show 3
+social_duo chat --session 3
+```
+
+## Commands
+
+- `social_duo init`
+- `social_duo post`
+- `social_duo reply`
+- `social_duo discuss`
+- `social_duo molt`
+- `social_duo chat`
+- `social_duo history`
+- `social_duo config`
+
+## Troubleshooting
+
+- Missing key: set `OPENAI_API_KEY` in your environment.
+- Base URL errors: set `OPENAI_BASE_URL` (default is `https://api.openai.com/v1`).
+- Model errors: set `OPENAI_MODEL` to a valid chat model name for your provider.
+
+## Notes
+
+- All artifacts are stored in `.social-duo/` in the current directory.
+- Use `--json` for machine-readable output.
+- Use `--verbose` to see full agent exchanges.
+
+## NPM Wrapper
+
+If you want an npm package that installs the Python CLI from GitHub:
+
+```bash
+npm i -g social-duo
+social-duo --help
+```
+
+This uses the GitHub repo as the install source and creates a venv under `~/.social-duo/venv`.

package/npm/install.js

@@ -0,0 +1,44 @@
+const { execFileSync } = require("child_process");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+const REPO_URL = "https://github.com/ethnmcl/social-duo.git";
+const HOME = os.homedir();
+const BASE_DIR = path.join(HOME, ".social-duo");
+const VENV_DIR = path.join(BASE_DIR, "venv");
+
+function ensureDir(p) {
+  if (!fs.existsSync(p)) {
+    fs.mkdirSync(p, { recursive: true });
+  }
+}
+
+function getPython() {
+  return process.platform === "win32" ? "python" : "python3";
+}
+
+function venvBin() {
+  return process.platform === "win32" ? path.join(VENV_DIR, "Scripts") : path.join(VENV_DIR, "bin");
+}
+
+function run(cmd, args) {
+  execFileSync(cmd, args, { stdio: "inherit" });
+}
+
+function main() {
+  ensureDir(BASE_DIR);
+
+  const python = getPython();
+  if (!fs.existsSync(VENV_DIR)) {
+    run(python, ["-m", "venv", VENV_DIR]);
+  }
+
+  const binDir = venvBin();
+  const pip = process.platform === "win32" ? path.join(binDir, "pip.exe") : path.join(binDir, "pip");
+
+  // Install/upgrade from GitHub repo
+  run(pip, ["install", "--upgrade", `git+${REPO_URL}`]);
+}
+
+main();

package/npm/run.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+const { spawnSync } = require("child_process");
+const os = require("os");
+const path = require("path");
+const fs = require("fs");
+
+const HOME = os.homedir();
+const BASE_DIR = path.join(HOME, ".social-duo");
+const VENV_DIR = path.join(BASE_DIR, "venv");
+
+function venvBin() {
+  return process.platform === "win32" ? path.join(VENV_DIR, "Scripts") : path.join(VENV_DIR, "bin");
+}
+
+function main() {
+  const binDir = venvBin();
+  const exe = process.platform === "win32" ? "social_duo.exe" : "social_duo";
+  const cli = path.join(binDir, exe);
+
+  if (!fs.existsSync(cli)) {
+    console.error("social-duo is not installed. Try reinstalling the npm package.");
+    process.exit(1);
+  }
+
+  const args = process.argv.slice(2);
+  const result = spawnSync(cli, args, { stdio: "inherit" });
+  process.exit(result.status ?? 0);
+}
+
+main();

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "social-duo",
+  "version": "0.1.0",
+  "description": "MyVillage Network - Python CLI wrapper",
+  "bin": {
+    "social-duo": "npm/run.js"
+  },
+  "scripts": {
+    "postinstall": "node npm/install.js"
+  },
+  "files": [
+    "npm/**"
+  ],
+  "license": "MIT"
+}