README.md

metadata

title: Agentic Multiwriter
emoji: 🧠
colorFrom: indigo
colorTo: pink
sdk: gradio
sdk_version: 6.1.0
app_file: app.py
pinned: false

Agentic Multiwriter

A multi-agent research & writing system built with LangGraph, LangChain, and local/remote LLMs.

Pipeline:

1. Researcher – web search on a topic
2. Aggregator – cleans & deduplicates snippets
3. Writer – drafts content based on research
4. Critic – improves clarity & completeness
5. Formatter – outputs a final, mode-specific format (blog / research_summary / linkedin_post)

Supports:

• Local LLM via Ollama (e.g. llama3)
• Optional OpenAI models (if configured)
• REST API with FastAPI
• CLI entrypoint

---

Quickstart

# From repo root
python -m venv .venv
source .venv/bin/activate

pip install -e .

# Run CLI
PYTHONPATH=src python -m agentic_multiwriter.cli.main \
  --topic "Future of AI agents in healthcare" \
  --mode blog

# Run API
PYTHONPATH=src uvicorn agentic_multiwriter.api.server:app --reload
Example request:

bash
Copy code
curl -X POST "http://127.0.0.1:8000/generate" \
  -H "Content-Type: application/json" \
  -d '{"topic": "Future of AI agents in healthcare", "mode": "blog"}'
Configuration
Environment variables:

AMW_LLM_PROVIDER – "ollama" or "openai" (default: "ollama")

AMW_LLM_MODEL – e.g. "llama3" (default) or "gpt-4o-mini"

AMW_TEMPERATURE – float, default 0.4

OPENAI_API_KEY – required if using openai provider

You can also see example configs in examples/sample_config_local.yaml and examples/sample_config_hybrid.yaml.

Development
Run tests:

bash
Copy code
PYTHONPATH=src pytest -q
License
MIT (or whatever you prefer).

bash
Copy code

---

## `docker-compose.yml`

```yaml
version: "3.9"

services:
  api:
    build: .
    container_name: agentic-multiwriter-api
    environment:
      - AMW_LLM_PROVIDER=${AMW_LLM_PROVIDER:-ollama}
      - AMW_LLM_MODEL=${AMW_LLM_MODEL:-llama3}
      - AMW_TEMPERATURE=${AMW_TEMPERATURE:-0.4}
      - OPENAI_API_KEY=${OPENAI_API_KEY:-}
    ports:
      - "8000:8000"
    command: ["uvicorn", "agentic_multiwriter.api.server:app", "--host", "0.0.0.0", "--port", "8000"]
    working_dir: /app
    volumes:
      - ./src:/app/src
      - ./examples:/app/examples