https://github.com/ag2ai/ag2-copilotkit-starter
This repository contains a simple starter project that demonstrates how to build AI agents with AG2 that interact with CopilotKit.
Science Score: 26.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (12.3%) to scientific vocabulary
Repository
This repository contains a simple starter project that demonstrates how to build AI agents with AG2 that interact with CopilotKit.
Statistics
- Stars: 7
- Watchers: 5
- Forks: 0
- Open Issues: 0
- Releases: 0
Metadata Files
README.md
CopilotKit-AG2 Starter
This repository contains a simple starter project that demonstrates how to build AI agents with AG2 that interact with CopilotKit.
Project Structure
ag2-copilotkit-starter/
├── agent-py/ # Python backend with AG2 agents
│ └── simple_workflow.py
│ └── hitl_workflow.py
└── ui/ # Frontend application
Prerequisites
- Python 3.9 or newer
- Node.js 18.18.0 or newer (specifically: ^18.18.0 || ^19.8.0 || >= 20.0.0)
- pnpm (for package management)
- OpenAI API key
Backend Setup
1. Install Python Backend Dependencies
Note: We recommend using a virtual environment for your project to keep your packages contained. See venv.
sh
cd agent-py
pip install -r requirements.txt
2. Set up your API Key
Before running the code, you need to set your OpenAI API key as an environment variable:
macOS/Linux:
sh
export OPENAI_API_KEY="your_openai_api_key"
Windows:
sh
setx OPENAI_API_KEY "your_openai_api_key"
Note: This example (simple_workflow.py) uses
gpt-4o-miniby default, but you can replace it with any other model supported by AG2 by modifying the configuration in the code.
3. Start the Backend Server
The command below assumes that you are already inside the agent-py directory. If not please cd into the directory before running the command.
sh
uvicorn simple_workflow:app --port 8008 --reload
The command above starts the simple agent chat workflow. You can explore other workflows available in the
agent-pydirectory, try them out, or even create your own. Each workflow file includes the command to run it at the bottom.
The backend server will start at http://localhost:8008.
Frontend Setup
1. Install Frontend Dependencies
Open a new terminal session and run the below command
sh
cd ui
pnpm i
2. Start the Frontend Application
The command below assumes that you are already inside the ui directory. If not please cd into the directory before running the command.
sh
pnpm run dev
The frontend application will start at http://localhost:3000.
After starting the frontend, please allow a few moments for the Next.js application to compile fully. Once compilation is complete, you can interact with the chat window to communicate with the AG2 agent.
Additional Resources
Owner
- Name: ag2ai
- Login: ag2ai
- Kind: organization
- Repositories: 1
- Profile: https://github.com/ag2ai
GitHub Events
Total
- Watch event: 7
- Delete event: 1
- Member event: 1
- Push event: 16
- Pull request event: 5
- Fork event: 1
- Create event: 5
Last Year
- Watch event: 7
- Delete event: 1
- Member event: 1
- Push event: 16
- Pull request event: 5
- Fork event: 1
- Create event: 5
Committers
Last synced: about 1 year ago
Top Committers
| Name | Commits | |
|---|---|---|
| Harish Mohan Raj | h****h@a****i | 16 |
| Davor Runje | z****i@g****m | 1 |
Committer Domains (Top 20 + Academic)
Issues and Pull Requests
Last synced: about 1 year ago
All Time
- Total issues: 0
- Total pull requests: 3
- Average time to close issues: N/A
- Average time to close pull requests: less than a minute
- Total issue authors: 0
- Total pull request authors: 1
- Average comments per issue: 0
- Average comments per pull request: 0.0
- Merged pull requests: 3
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 3
- Average time to close issues: N/A
- Average time to close pull requests: less than a minute
- Issue authors: 0
- Pull request authors: 1
- Average comments per issue: 0
- Average comments per pull request: 0.0
- Merged pull requests: 3
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
- harishmohanraj (6)
Top Labels
Issue Labels
Pull Request Labels
Dependencies
- @types/node ^22.0.0 development
- @types/react 19.0.1 development
- @types/react-dom 19.0.2 development
- eslint ^9.0.0 development
- eslint-config-next 15.1.0 development
- postcss ^8 development
- tailwindcss ^3.4.1 development
- typescript ^5 development
- @agentwire/client 0.0.26
- @agentwire/core 0.0.26
- @agentwire/encoder 0.0.26
- @agentwire/proto 0.0.26
- @copilotkit/react-core 0.0.0-mme-awp-20250407201240
- @copilotkit/react-ui 0.0.0-mme-awp-20250407201240
- @copilotkit/runtime 0.0.0-mme-awp-20250407201240
- @copilotkit/runtime-client-gql 0.0.0-mme-awp-20250407201240
- @copilotkit/shared 0.0.0-mme-awp-20250407201240
- @radix-ui/react-accordion ^1.2.0
- @radix-ui/react-icons ^1.3.2
- @radix-ui/react-slot ^1.1.0
- class-variance-authority ^0.7.0
- clsx ^2.1.1
- framer-motion ^11.3.31
- lucide-react ^0.436.0
- next 15.1.0
- openai ^4.85.1
- react 19.0.0
- react-dom 19.0.0
- react-markdown ^9.0.1
- rxjs 7.8.1
- tailwind-merge ^2.5.2
- tailwindcss-animate ^1.0.7
- 168 dependencies
- fastagency *