Skip to main content

Adaptive Agentic AI Reasoning That Empower, Inform, and Integrate Seamlessly

Project description

AgenticFleet

Codacy Badge

AgenticFleet is an Adaptative Agentic System that leverages Chainlit for the frontend interface and FastAPI for the backend, built on the foundation of Autogen & Magentic-One.

https://github.com/user-attachments/assets/e36b215a-4fac-4b2a-95e2-90ce7701f277

Quick Links

Features

  • Interactive Chainlit 2.0 chat interface
  • FastAPI backend with structured logging and WebSocket support
  • General Multi-tasking Agentic System based on Magentic-One
  • Advanced prompt engineering with PromptFleet templates
  • Dataset and prompt fabric tools for AI training
  • Comprehensive error handling and connection management
  • Environment-based configuration
  • Extensible architecture for future enhancements
  • OAuth support with ability to run with or without authentication

Installation

From PyPI

Recommended: create a virtual environment using uv:

uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows

The simplest way to install AgenticFleet is via pip:

pip install agentic-fleet # uv install agentic-fleet   

Copy the example environment file and update it with your settings:

cp .env.example .env

Install Playwright dependencies:

playwright install --with-deps chromium

Then, you can run the application using one of these commands:

agenticfleet start      # Start with OAuth authentication enabled
agenticfleet no-oauth   # Start without OAuth authentication

The application will be available at http://localhost:8001

From Source

  1. Clone the repository:
git clone https://github.com/qredence/agenticfleet.git
cd agenticfleet
  1. Create and activate a virtual environment using uv:
uv venv
. .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows
  1. Install dependencies:

Additional dependencies may be required for certain features. For example, to install Playwright dependencies:

sudo playwright install-deps
sudo apt install -y nodejs npm
npx playwright install-deps

Roadmap (short-term)

Current Progress:

  • Implement core multi-agent architecture
  • Add Multi-modal Surfer agent
  • Add FileSurfer agent
  • Integrate Chainlit 2.0 frontend
  • Add OAuth authentication support
  • Implement real-time streaming responses
  • Add CogCache integration

Short-term Goals:

  • Add Composio Agent
  • Implement LLM model auto-selection
  • Enhance agent coordination
  • Add message persistence
  • Improve file handling capabilities
  • Release AgenticFabric
  • Implement GraphFleet integration
  • Develop AI training tools

Mid-term Goals:

  • Launch cloud service with OAuth + Freetier
  • Create comprehensive prompt engineering suite
  • Build enterprise deployment options
  • Establish agent marketplace
  • Enable cross-platform interoperability
  • Enhance UI/UX features
  • Implement advanced monitoring
  • Add automated error recovery

Prerequisites

  • Python 3.10 or later
  • uv package manager
  1. Configure environment variables:

Copy the example environment file and update it with your settings:

cp .env.example .env

The .env file contains all necessary configuration for both backend and frontend:

  • Azure Services configuration (OpenAI, Key Vault, etc.)
  • External AI Services API keys
  • Backend server settings
  • Frontend (Chainlit) configuration

Development

To start the application in development mode:

# Ensure you're in the virtual environment
. .venv/bin/activate

# Start the Chainlit application
chainlit run src/app/app.py

This will:

  • Launch the Chainlit interface at http://localhost:8001
  • Enable real-time agent communication
  • Provide colored logging output
  • Handle graceful shutdown

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Please ensure your PR:

  • Includes appropriate tests
  • Updates documentation as needed
  • Follows the existing code style
  • Includes proper error handling
  • Has meaningful commit messages

Citation

@misc{fourney2024magenticonegeneralistmultiagentsolving,
    title={Magentic-One: A Generalist Multi-Agent System for Solving Complex Tasks},
    author={Adam Fourney and Gagan Bansal and Hussein Mozannar and Cheng Tan and Eduardo Salinas 
            and Erkang and Zhu and Friederike Niedtner and Grace Proebsting and Griffin Bassman 
            and Jack Gerrits and Jacob Alber and Peter Chang and Ricky Loynd and Robert West 
            and Victor Dibia and Ahmed Awadallah and Ece Kamar and Rafah Hosn and Saleema Amershi},
    year={2024},
    eprint={2411.04468},
    archivePrefix={arXiv},
    primaryClass={cs.AI},
    url={https://arxiv.org/abs/2411.04468}
}

For more information about Autogen, visit their documentation.

License

This project is licensed under the Apache 2.0 License.

Star History

Star History Chart

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

agentic_fleet-0.4.31.tar.gz (313.0 kB view details)

Uploaded Source

Built Distribution

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

agentic_fleet-0.4.31-py3-none-any.whl (83.0 kB view details)

Uploaded Python 3

File details

Details for the file agentic_fleet-0.4.31.tar.gz.

File metadata

  • Download URL: agentic_fleet-0.4.31.tar.gz
  • Upload date:
  • Size: 313.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.5.14

File hashes

Hashes for agentic_fleet-0.4.31.tar.gz
Algorithm Hash digest
SHA256 c53b85f79011c9e600b3e4817d4a4c72c30e020ef83a48029ef459965a45f042
MD5 3a2cc9c3fe0594da47994607b169dcc2
BLAKE2b-256 3e394f758950cb0f70f01d572ec09bc01421da0fa323539cfd50f4dc3ed8c4f4

See more details on using hashes here.

File details

Details for the file agentic_fleet-0.4.31-py3-none-any.whl.

File metadata

File hashes

Hashes for agentic_fleet-0.4.31-py3-none-any.whl
Algorithm Hash digest
SHA256 507254a743284d9593f02b2844b62d1983e08d7d31b33d25663104b96926ba12
MD5 497908fd59da04c10a9e74499348419a
BLAKE2b-256 8ffe5e9c4e74e289faa13be40a598306a343a5319db2f9ffc8b91d7d56a4f523

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