README.md

metadata

title: Wisdom Poster
emoji: 🪷
colorFrom: indigo
colorTo: indigo
sdk: gradio
sdk_version: 6.2.0
app_file: app.py
pinned: false

Wisdom Poster — Hugging Face Space

This Space generates short wisdom text and a matching image, then posts the result to a Facebook Page. The app supports both OpenAI and Replicate image generation; it will try providers in the order configured by the PROVIDER_ORDER environment variable (default: openai,replicate).

Quick setup (local)

1. Install dependencies:

python -m pip install -r requirements.txt

2. Create a local .env (do NOT commit it). Example keys used by the app:

• FB_PAGE_ID — the numeric Page ID
• FB_PAGE_ACCESS_TOKEN — a Page access token with pages_manage_posts / publish permissions
• OPENAI_API_KEY — (optional) OpenAI API key if using OpenAI image generation
• REPLICATE_API_TOKEN — (optional) Replicate API key if using Replicate
• REPLICATE_MODEL — (optional) default replicate model ref (owner/name:version), e.g. google/nano-banana
• PROVIDER_ORDER — (optional) e.g. replicate,openai or openai,replicate (default openai,replicate)
• RUN_DAILY_REPLICATE — (optional) true to enable scheduled daily runs inside app.py
• DAILY_INTERVAL_HOURS — (optional) schedule interval in hours (default 24)
• DAILY_PROMPT — (optional) override prompt for scheduled runs

Deploying to Hugging Face Spaces

1. In your Space settings, set the following Secrets (Settings → Secrets):

• FB_PAGE_ACCESS_TOKEN
• FB_PAGE_ID
• REPLICATE_API_TOKEN (if you plan to use Replicate)
• OPENAI_API_KEY (if you plan to use OpenAI)
• PROVIDER_ORDER (optional)
• RUN_DAILY_REPLICATE (set to true to enable daily runs)

2. Ensure app.py and requirements.txt are present at the repository root. The Space entrypoint is app.py (specified in the metadata above).

Notes and recommendations

• The app spawns a daemon background thread for scheduled runs when RUN_DAILY_REPLICATE is enabled. This works while the Space process is active but can be interrupted during redeploys — for guaranteed scheduling, use an external scheduler.
• Keep your Space private if you do not want the public to access the UI or to expose functionality.
• Monitor usage and API costs for OpenAI/Replicate.

Troubleshooting

• If the Space fails to start, check the requirements.txt includes all needed packages and that Secrets are set.
• Use the Space logs (Settings → Logs) to inspect runtime errors.

Minimal files to leave in the Space repo

• app.py (entrypoint)
• requirements.txt
• generate_image.py, generate_wisdom.py, post_to_facebook.py
• .gitignore (ignore .env, generated images)

If you want, I can also add a short Deploy checklist file with exact steps and screenshot guidance for adding Secrets in the HF UI.

Post to Facebook Page

This repository includes a small Python script to post a message to a Facebook Page using a Page Access Token stored in a .env file.

Setup

1. Install dependencies:

python -m pip install -r requirements.txt

2. Populate your .env (do not commit secrets). Example keys used by the script:

• FB_PAGE_ID — the numeric Page ID
• FB_PAGE_ACCESS_TOKEN — a Page access token with pages_manage_posts or appropriate publish permissions
• MESSAGE — optional default message
• LINK — optional link to attach

Usage

Run directly with a message:

python post_to_facebook.py --message "Hello from script"

Or rely on MESSAGE in .env:

python post_to_facebook.py

Notes

• The script posts to the Graph API endpoint /{page-id}/feed.
• If you need long-lived tokens or other flows, exchange tokens using Facebook's API before placing them in .env.