// automation · ZJU-REAL/Easel

Easel

An open-source AI agent for social media — find trends, create, publish and learn what works.

★ 3.3k stars⑂ 503 forksApache-2.0updated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

Easel is an open-source automation project by ZJU-REAL (ZJU-REAL/Easel on GitHub). It has 3,274 GitHub stars and 503 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 7 October 2026.

Repository
ZJU-REAL/Easel
GitHub stars
3,274
Forks
503
License
Apache-2.0
Last updated on GitHub
7 October 2026
Category
Automation
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide the first concrete outcome you want from it, so you can pick the right example, template or mode instead of exploring everything at once.

  2. Get the project

    Clone the repository (or install the published package) and skim its README quick start for the requirements for your platform.

  3. Install and configure

    Run the documented install step and set any required configuration — such as provider keys, data sources or local services — before the first run.

  4. Run your first task

    Execute the smallest documented example end to end, confirm the output is what you expected, then adapt it to your real data or workflow.

// features

Why people love it

One agent, full pipeline

Trend discovery, topic evaluation, calendar planning, copy/visual/video creation, publishing and attribution in one workflow.

Profile-driven, not one-shot

Per-account positioning, style, audience, platform preferences and memory make output fit the account better over time.

Skills that execute

Image, card, voice-over, subtitle, editing, short-drama and publishing skills ship with runnable scripts; outputs land in outputs/.

One source, many formats

Rework one topic into a Xiaohongshu card set, a short video, a Zhihu long post or a short post, respecting each platform's format and length.

Real publishing and feedback

Login, adaptation and publishing for seven platforms, with account data pulled back for review.

Project-based archiving

Content, assets, intermediate files and metadata are stored per project for later edits and retries.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source so you can inspect, configure and run it locally.

    git clone https://github.com/ZJU-REAL/Easel.git
    cd Easel
  2. Install Easel

    Clone and run the setup script (PowerShell setup.ps1 on Windows).

    git clone https://github.com/ZJU-REAL/Easel.git
    cd Easel
    bash setup.sh
  3. Or install manually

    Create a venv, install in editable mode, install Playwright's Chromium, and ensure ffmpeg is present; then configure your accounts/models as the README describes.

    python3 -m venv .venv && source .venv/bin/activate
    python3 -m pip install -e .
    python3 -m playwright install chromium  # ffmpeg must be installed separately
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains Easel?

It is maintained by ZJU-REAL on GitHub (ZJU-REAL/Easel), where the source, issues and releases live.

Is it free to use?

Yes — it is free and open source under Apache-2.0, which permits use, modification and commercial redistribution, with licence/notice retention.

Does it need a paid API key?

Yes — content generation uses LLM/media providers you configure, and publishing requires logging into your own platform accounts; see the README configuration section.

How does it compare to generic AI content generators that stop at copy?

Compared with generic AI content generators that stop at copy, Easel's distinguishing focus is: an open-source AI agent for social media — find trends, create, publish and learn what works. Pick it when that focus matches your need; the alternative may suit you better if its broader or different scope is the priority.

How do I get started?

Clone https://github.com/ZJU-REAL/Easel (or install its published package), follow the README quick start to install and configure it, then run the smallest documented example — the Run section on this page mirrors those steps.

// keep exploring

Similar tools

Automation

10xProductivity

Personal AI assistant that works inside strict corporate IT constraints.

★ 478 starsMIT
View guide →
Automation

sudocode

Lightweight agent orchestration tooling that lives inside your repo.

★ 293 starsApache-2.0
View guide →
Automation

Everfern

A free AI agent that drives your computer like you would.

★ 92 starsMIT
View guide →
Automation

comanda

CLI orchestrator that runs AI agent workflows from declarative YAML.

★ 328 starsMIT
View guide →
Automation

AI_Find_Customer

Run ai_find_customer locally: 面向外贸与 b2b 场景的 ai 客户挖掘系统,基于 fastapi、langgraph 和 react,实现.

★ 181 starsMIT
View guide →
Automation

Huginn

Create agents that monitor and act on your behalf. Your agents are standing by!

★ 50.0k starsMIT
View guide →
// alternatives

Alternatives in Automation

The most-starred other Automation projects in the LibreAI catalogue — the realistic shortlist if Easel is not the right fit.

Get Easel

Free and open — grab the source, star the repo, and start creating.