Skip to main content

Peeps AI is a platform for decentralized AI agents, designed to provide individuals and communities with accessible, transparent and collaborative AI solutions.

Project description

Peeps AI - Advanced Multi-Agent Orchestration

GitHub release
GitHub stars
GitHub issues
GitHub license
Python version

๐Ÿง  Production-Grade AI Agent Framework

Peeps AI is a powerful framework designed to orchestrate autonomous AI agents that work together seamlessly to execute complex tasks. Whether you're automating workflows, developing AI-powered assistants, or managing data-driven decisions, Peeps AI enables intelligent multi-agent collaboration with fine-grained control and predictable execution.

๐Ÿ”— Website: peepsai.io
๐Ÿ“– Documentation: Read the Docs
๐Ÿ’ฌ Community: Telegram | Twitter


โœจ Features

โœ… Multi-Agent Collaboration - Define AI agents with specialized roles, goals, and tools.
โœ… Autonomous Task Delegation - Agents dynamically assign tasks based on expertise.
โœ… Production-Ready Architecture - Robust error handling, state management, and extensibility.
โœ… Process Control with Workchains - Create AI-driven workflows with fine-tuned execution.
โœ… Customizable & Extensible - Use built-in tools or integrate your own.
โœ… Blockchain-Enhanced Transparency - Use Peeps AI with ERC20-based governance.


๐Ÿš€ Quickstart

1๏ธโƒฃ Install Peeps AI

pip install git+https://github.com/PeepsAI/PeepsAI.git

Or, if you want to install it with optional tools, use:

pip install git+https://github.com/PeepsAI/PeepsAI.git#egg=peepsai[tools]

If you prefer to clone the repository manually and install it:

git clone https://github.com/PeepsAI/PeepsAI.git
cd PeepsAI
pip install .

2๏ธโƒฃ Create Your First Group (Peeps Group)

peepsai create group my_project

This generates the following structure:

my_project/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ main.py       # Entry point
โ”‚   โ”œโ”€โ”€ group.py      # AI group logic
โ”‚   โ”œโ”€โ”€ tools/        # Custom AI tools
โ”‚   โ”œโ”€โ”€ config/
โ”‚   โ”‚   โ”œโ”€โ”€ agents.yaml  # Agent definitions
โ”‚   โ”‚   โ”œโ”€โ”€ tasks.yaml   # Task definitions
โ”œโ”€โ”€ .env             # API keys (LLMs, etc.)
โ”œโ”€โ”€ pyproject.toml   # Dependencies
โ”œโ”€โ”€ README.md        # Project description

3๏ธโƒฃ Run Your AI Agents

Execute your AI workflow with:

peepsai run

Or run manually:

python src/my_project/main.py

๐Ÿ— Example - AI Research & Reporting

Define your AI agents in config/agents.yaml:

researcher:
  role: "Senior AI Researcher"
  goal: "Uncover the latest advancements in AI"
  backstory: "Expert in deep learning, NLP, and AI ethics."

reporting_analyst:
  role: "AI Market Analyst"
  goal: "Analyze AI trends and create detailed reports."

And set up tasks in config/tasks.yaml:

research_task:
  description: "Find the most relevant AI breakthroughs of 2024."
  expected_output: "10 key AI developments in bullet points."
  agent: researcher

reporting_task:
  description: "Expand the findings into a structured market report."
  expected_output: "A Markdown-formatted AI industry report."
  agent: reporting_analyst
  output_file: report.md

๐Ÿ›  Advanced Use Cases

๐Ÿ”น AI-Powered Assistants - Build autonomous virtual agents.
๐Ÿ”น Data Analysis Pipelines - Automate research and reporting.
๐Ÿ”น Business Workflow Automation - AI-driven decision-making.
๐Ÿ”น Decentralized AI Governance - Integrate Peeps AI with blockchain.


๐ŸŽฏ Roadmap

๐ŸŸข 2024 - Foundation & Core Framework
๐ŸŸ  2025 - GUI, Staking, & Smart Contracts
๐Ÿ”ด 2026+ - AI NFT Agents & Cross-Chain Integration

๐Ÿ“Œ View full Peeps AI Roadmap.


๐Ÿค Contributing

We welcome open-source contributions! To contribute:

  1. Fork the repo
  2. Create a new branch (feature-xyz)
  3. Commit your changes
  4. Submit a Pull Request

๐Ÿ”— Follow us on Twitter โ†’ @peeps_ai

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

peepsai-0.1.3.tar.gz (921.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

peepsai-0.1.3-py3-none-any.whl (228.9 kB view details)

Uploaded Python 3

File details

Details for the file peepsai-0.1.3.tar.gz.

File metadata

  • Download URL: peepsai-0.1.3.tar.gz
  • Upload date:
  • Size: 921.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.4

File hashes

Hashes for peepsai-0.1.3.tar.gz
Algorithm Hash digest
SHA256 f1481f6785f75c060170dd8dd2b881f72813bea8fce0d1d094ab75feeda99752
MD5 aef8387408b700e372450ebc078118ad
BLAKE2b-256 21d5ae03df1b7ca07227c4fa9df17d1b1a763d4f8c1fb25ee08ce227dc599f79

See more details on using hashes here.

File details

Details for the file peepsai-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: peepsai-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 228.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.4

File hashes

Hashes for peepsai-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 9d3fcd6bf4a939adb949348122b058e6cada3e8ac19570875a74da9ba83fcf02
MD5 15598c18ccc942bfcda90f59d7498c1f
BLAKE2b-256 72f5e1a0e1c6a914816e4318992da51356663b6953ae4250f6e6a9b6feca0557

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page