| Name | blog-agent-framework JSON |
| Version |
1.0.1
JSON |
| download |
| home_page | None |
| Summary | An AI-powered library that orchestrates a team of agents to generate SEO-optimized, easy-to-read, story-based blog posts |
| upload_time | 2025-07-27 20:56:44 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.11 |
| license | MIT License
Copyright (c) 2024 Edilma Riano
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.
|
| keywords |
ai
autogen
llm
agent
orchestrator
content-generation
seo
blog
marketing
automation
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Blog Agent Framework
📖 También disponible en [Español](README.es.md)
An advanced framework for building AI-powered content generation pipelines. This project uses a multi-agent system, powered by Microsoft Autogen, to autonomously write, critique, and review articles for quality, compliance, and SEO.
**Create smarter, better blogs—autonomously.**
The **Blog Agent Framework** is a plug-and-play Python library that helps you generate high-quality blog posts using a team of AI agents. Built on top of Microsoft’s powerful [Autogen](https://microsoft.github.io/autogen) system, this framework mimics a professional content team: a writer, a critic, and multiple expert reviewers work together to craft concise, SEO-optimized, story-driven articles, designed to engage readers and rank well in search engines. Applies best practices in digital marketing to improve the reach, structure, and impact of each post.
Whether you're a solo blogger, content marketer, or developer, you can use this library to automate content creation or integrate it into your own API.
---
## 🔧 Features
**🧩 Modular Agent Architecture**
Includes specialized agents for:
- **Writer** – Crafts story-driven blog posts using simple, clear language
- **Content Marketing Reviewer** – Improves structure, flow, and engagement
- **Clarity & Ethics Reviewer** – Ensures content is easy to understand and free from misleading claims
- **SEO Reviewer** – Optimizes for discoverability on search engines like Google and AI tools
**💬 Intelligent Agent Collaboration**
Each agent plays a focused role in a structured review loop, and a meta-agent brings everything together into one polished result.
**📦 Use As a Library or API**
- Use the library directly in your Python projects
- Or build an API on top to serve real-time blog generation for your website or content service
**✅ SEO-Friendly & Reader-Focused**
Designed to help your content perform well on search engines *and* connect with real people—especially readers with a basic or general reading level.
## 📁 Project Structure
The project is structured as a standard Python package, making it easy to install and use.
```
.
├── blog_agent_framework/ # The main library source code
│ ├── agents/ # Contains the logic for individual AI agents
│ ├── utils/ # Utility functions and helpers
│ ├── __init__.py # Exposes the main generation function
│ └── config.py # Handles model client configuration
│
├── examples/ # Self-contained examples for users
│ ├── .env.example # Template for environment variables
│ └── run_example.py # Main script to demonstrate library usage
│
├── .gitignore # Specifies which files Git should ignore
├── LICENSE # The open-source license for the project
├── pyproject.toml # The modern configuration file for the package
└── README.md # This file!
```
## 🚀 Installation
[](https://badge.fury.io/py/blog-agent-framework)
Install from PyPI:
```bash
pip install blog-agent-framework
```
<sub>Requires Python 3.11+</sub>
Install the Blog Agent Framework directly from GitHub using pip:
```bash
pip install git+https://github.com/edilma/AI-Agent-Orchestrator.git
```
## ✍️ Basic Usage
Here's how to quickly get started with the built-in example.
### Running the Example
1. Navigate into the examples directory:
```bash
cd examples
```
2. Create your own .env file by copying the template.
```bash
# On Windows
copy .env.example .env
# On macOS or Linux
cp .env.example .env
```
3. Add your OpenAi credentials to the new .env file
```bash
OPENAI_API_KEY=your_openai_key_here
OPENAI_PROJECT_ID=your_project_id_here
```
4. Run the example script:
```bash
python run_example.py
```
## 🧠 How It Works
The Blog Agent Framework simulates a collaborative writing and editing process using a team of specialized AI agents. Each agent plays a unique role in refining the blog post.
1. **Writer Agent**
Creates an initial blog post based on a topic prompt. The post is designed to be simple, engaging, and story-driven.
2. **Critic Agent**
Reviews the writer's draft and offers direct, actionable feedback. This agent evaluates story structure, clarity, tone, and flow—and helps polish the final version by incorporating all key reviewer suggestions.
3. **SEO Reviewer**
Ensures the blog includes relevant keywords, strong headings, and other on-page SEO elements to improve visibility on AI and search engines like Google and attracts organic traffic.
4. **Content Marketing Reviewer**
Analyzes structure, engagement, and presentation. Helps make sure the blog is clear, logically organized, and engaging for readers.
5. **Clarity and Ethics Reviewer**
Checks that the writing is easy to understand for a general audience, free of confusing or problematic language, and appropriate for public consumption.
The agents communicate intelligently to revise and refine the blog post until it meets quality standards for readability, SEO, and flow.
## 📜 License
This project is licensed under the [MIT License](LICENSE).
You are free to use, modify, and distribute this software for personal or commercial use, with attribution.
## ✨ Author
Created with 💻 by **Edilma Riano**
Helping businesses and creators use AI to work smarter and scale faster.
🐙 [Follow me on GitHub](https://github.com/edilma)
Raw data
{
"_id": null,
"home_page": null,
"name": "blog-agent-framework",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "ai, autogen, llm, agent, orchestrator, content-generation, seo, blog, marketing, automation",
"author": null,
"author_email": "Edilma Riano <edilmadev@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/8f/b7/1c24d2c7c430805561b7fe1274dcaa73530e12aa5edf94cbfe1d7f0e3a72/blog_agent_framework-1.0.1.tar.gz",
"platform": null,
"description": "# Blog Agent Framework\r\n\ud83d\udcd6 Tambi\u00e9n disponible en [Espa\u00f1ol](README.es.md)\r\n\r\nAn advanced framework for building AI-powered content generation pipelines. This project uses a multi-agent system, powered by Microsoft Autogen, to autonomously write, critique, and review articles for quality, compliance, and SEO.\r\n**Create smarter, better blogs\u2014autonomously.**\r\n\r\nThe **Blog Agent Framework** is a plug-and-play Python library that helps you generate high-quality blog posts using a team of AI agents. Built on top of Microsoft\u2019s powerful [Autogen](https://microsoft.github.io/autogen) system, this framework mimics a professional content team: a writer, a critic, and multiple expert reviewers work together to craft concise, SEO-optimized, story-driven articles, designed to engage readers and rank well in search engines. Applies best practices in digital marketing to improve the reach, structure, and impact of each post. \r\n\r\nWhether you're a solo blogger, content marketer, or developer, you can use this library to automate content creation or integrate it into your own API.\r\n\r\n---\r\n\r\n## \ud83d\udd27 Features\r\n**\ud83e\udde9 Modular Agent Architecture** \r\n Includes specialized agents for:\r\n - **Writer** \u2013 Crafts story-driven blog posts using simple, clear language \r\n - **Content Marketing Reviewer** \u2013 Improves structure, flow, and engagement \r\n - **Clarity & Ethics Reviewer** \u2013 Ensures content is easy to understand and free from misleading claims \r\n - **SEO Reviewer** \u2013 Optimizes for discoverability on search engines like Google and AI tools\r\n\r\n**\ud83d\udcac Intelligent Agent Collaboration** \r\n Each agent plays a focused role in a structured review loop, and a meta-agent brings everything together into one polished result.\r\n\r\n**\ud83d\udce6 Use As a Library or API** \r\n - Use the library directly in your Python projects \r\n - Or build an API on top to serve real-time blog generation for your website or content service\r\n\r\n**\u2705 SEO-Friendly & Reader-Focused** \r\n Designed to help your content perform well on search engines *and* connect with real people\u2014especially readers with a basic or general reading level.\r\n\r\n## \ud83d\udcc1 Project Structure\r\nThe project is structured as a standard Python package, making it easy to install and use.\r\n\r\n ```\r\n .\r\n \u251c\u2500\u2500 blog_agent_framework/ # The main library source code\r\n \u2502 \u251c\u2500\u2500 agents/ # Contains the logic for individual AI agents\r\n \u2502 \u251c\u2500\u2500 utils/ # Utility functions and helpers\r\n \u2502 \u251c\u2500\u2500 __init__.py # Exposes the main generation function\r\n \u2502 \u2514\u2500\u2500 config.py # Handles model client configuration\r\n \u2502\r\n \u251c\u2500\u2500 examples/ # Self-contained examples for users\r\n \u2502 \u251c\u2500\u2500 .env.example # Template for environment variables\r\n \u2502 \u2514\u2500\u2500 run_example.py # Main script to demonstrate library usage\r\n \u2502\r\n \u251c\u2500\u2500 .gitignore # Specifies which files Git should ignore\r\n \u251c\u2500\u2500 LICENSE # The open-source license for the project\r\n \u251c\u2500\u2500 pyproject.toml # The modern configuration file for the package\r\n \u2514\u2500\u2500 README.md # This file!\r\n\r\n ```\r\n\r\n## \ud83d\ude80 Installation\r\n\r\n[](https://badge.fury.io/py/blog-agent-framework)\r\n\r\n\r\nInstall from PyPI:\r\n\r\n```bash\r\npip install blog-agent-framework\r\n```\r\n<sub>Requires Python 3.11+</sub>\r\n\r\nInstall the Blog Agent Framework directly from GitHub using pip:\r\n\r\n```bash\r\npip install git+https://github.com/edilma/AI-Agent-Orchestrator.git\r\n```\r\n\r\n## \u270d\ufe0f Basic Usage\r\nHere's how to quickly get started with the built-in example.\r\n\r\n### Running the Example\r\n\r\n1. Navigate into the examples directory:\r\n ```bash\r\n cd examples\r\n ```\r\n\r\n2. Create your own .env file by copying the template. \r\n ```bash\r\n # On Windows\r\n copy .env.example .env\r\n\r\n # On macOS or Linux\r\n cp .env.example .env\r\n ```\r\n\r\n3. Add your OpenAi credentials to the new .env file\r\n ```bash\r\n OPENAI_API_KEY=your_openai_key_here\r\n OPENAI_PROJECT_ID=your_project_id_here\r\n ```\r\n\r\n4. Run the example script:\r\n ```bash\r\n python run_example.py\r\n ```\r\n## \ud83e\udde0 How It Works\r\n\r\nThe Blog Agent Framework simulates a collaborative writing and editing process using a team of specialized AI agents. Each agent plays a unique role in refining the blog post.\r\n\r\n1. **Writer Agent** \r\n Creates an initial blog post based on a topic prompt. The post is designed to be simple, engaging, and story-driven.\r\n\r\n2. **Critic Agent** \r\n Reviews the writer's draft and offers direct, actionable feedback. This agent evaluates story structure, clarity, tone, and flow\u2014and helps polish the final version by incorporating all key reviewer suggestions.\r\n\r\n3. **SEO Reviewer** \r\n Ensures the blog includes relevant keywords, strong headings, and other on-page SEO elements to improve visibility on AI and search engines like Google and attracts organic traffic.\r\n\r\n4. **Content Marketing Reviewer** \r\n Analyzes structure, engagement, and presentation. Helps make sure the blog is clear, logically organized, and engaging for readers.\r\n\r\n5. **Clarity and Ethics Reviewer** \r\n Checks that the writing is easy to understand for a general audience, free of confusing or problematic language, and appropriate for public consumption.\r\n\r\nThe agents communicate intelligently to revise and refine the blog post until it meets quality standards for readability, SEO, and flow.\r\n\r\n## \ud83d\udcdc License\r\n\r\nThis project is licensed under the [MIT License](LICENSE). \r\nYou are free to use, modify, and distribute this software for personal or commercial use, with attribution.\r\n\r\n## \u2728 Author\r\n\r\nCreated with \ud83d\udcbb by **Edilma Riano** \r\nHelping businesses and creators use AI to work smarter and scale faster.\r\n\r\n\ud83d\udc19 [Follow me on GitHub](https://github.com/edilma) \r\n",
"bugtrack_url": null,
"license": "MIT License\r\n \r\n Copyright (c) 2024 Edilma Riano\r\n \r\n Permission is hereby granted, free of charge, to any person obtaining a copy\r\n of this software and associated documentation files (the \"Software\"), to deal\r\n in the Software without restriction, including without limitation the rights\r\n to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\r\n copies of the Software, and to permit persons to whom the Software is\r\n furnished to do so, subject to the following conditions:\r\n \r\n The above copyright notice and this permission notice shall be included in all\r\n copies or substantial portions of the Software.\r\n \r\n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r\n IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\r\n FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\r\n AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\r\n LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\r\n OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\r\n SOFTWARE.\r\n ",
"summary": "An AI-powered library that orchestrates a team of agents to generate SEO-optimized, easy-to-read, story-based blog posts",
"version": "1.0.1",
"project_urls": {
"Bug Tracker": "https://github.com/edilma/AI-Agent-Orchestrator/issues",
"Documentation": "https://github.com/edilma/AI-Agent-Orchestrator#readme",
"Homepage": "https://github.com/edilma/AI-Agent-Orchestrator",
"Source": "https://github.com/edilma/AI-Agent-Orchestrator"
},
"split_keywords": [
"ai",
" autogen",
" llm",
" agent",
" orchestrator",
" content-generation",
" seo",
" blog",
" marketing",
" automation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "7bcb4253cbcede2cb81d94cfa7a7613190a4de522dc52fdfeac94211fc1b1e6e",
"md5": "3c33bb99e1b77024171fd9ee98a41074",
"sha256": "f86dfec7cfbb45a0170fa838d6b40302c76735bd97735a2e1d6445a4c221c021"
},
"downloads": -1,
"filename": "blog_agent_framework-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3c33bb99e1b77024171fd9ee98a41074",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 10759,
"upload_time": "2025-07-27T20:56:43",
"upload_time_iso_8601": "2025-07-27T20:56:43.030929Z",
"url": "https://files.pythonhosted.org/packages/7b/cb/4253cbcede2cb81d94cfa7a7613190a4de522dc52fdfeac94211fc1b1e6e/blog_agent_framework-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8fb71c24d2c7c430805561b7fe1274dcaa73530e12aa5edf94cbfe1d7f0e3a72",
"md5": "89aeb5f1c200920935bb367fdb27ca8a",
"sha256": "bb61e3920729ab89a0830df893b94a3f2ed940257db763dc09f4d7b3ecfaea0a"
},
"downloads": -1,
"filename": "blog_agent_framework-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "89aeb5f1c200920935bb367fdb27ca8a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 14753,
"upload_time": "2025-07-27T20:56:44",
"upload_time_iso_8601": "2025-07-27T20:56:44.091500Z",
"url": "https://files.pythonhosted.org/packages/8f/b7/1c24d2c7c430805561b7fe1274dcaa73530e12aa5edf94cbfe1d7f0e3a72/blog_agent_framework-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-27 20:56:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "edilma",
"github_project": "AI-Agent-Orchestrator",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "blog-agent-framework"
}
