Note
π§ Active Development Phase π§
BER is under active development. Features and APIs are subject to change as we work toward a stable release. We welcome early adopters and value your feedback.
BER connects the tools you already use to manage your business with any third-party or internal system, letting you automate tasks and workflows using simple natural language commands powered by AI.
- π Repetitive manual tasks drain time and resources, reducing productivity and scalability.
- β BER helps engineers, developers, and businesses to integrate tools and APIs using the power of LLMs.
π‘ See how BER simplifies DNS management directly through GitHub Issues; one of many powerful use cases:
Tip
Want to see BER in action?
Check out our use cases documentation to explore examples of how BER can help you.
- Connect Your Tools: Link the software you already use with any system or API, eliminating manual work.
- Natural Language Commands: Automate tasks easily with AI-powered natural language instructions.
- Full Control Over AI: Fine-tune tasks using tools like Skills, Hooks, and Actions for accurate results.
- Made for Developers: Simple APIs and clear documentation make it easy to get started and customize.
- Open-Source Freedom: Apache License. No vendor lock-in, free, and supported by the community.
π‘ This diagram shows how BER connects the tools you already use to manage your business with other systems you currently handle manually:
Note
If you like drawings, check out our documentation website for architecture diagrams, workflows, and more!
BER comes with several built-in agents to help you get started:
- Cloudflare Agent: Helps manage DNS records
- Skills: DNS Management
- Mermaid Diagram Agent: Helps create various types of Mermaid diagrams
- Skills: Flowchart Diagrams, Pie Charts, Sequence Diagrams
- Product Owner Agent: Helps with story refinement, acceptance criteria, and estimation
- Skills: Acceptance Criteria, Story Estimation, Story Refinement
- Weather Visualization Agent: Helps visualize and analyze weather data using charts and diagrams
- Skills: Weather Trend Charts
Each agent can be customized and extended to meet your specific needs. For detailed information about configuring and using these agents, visit our documentation.
- Clone the repository:
git clone git@github.com:berbyte/ber-os.git
cd ber-os
- Install the dependencies:
go mod tidy
You can now decide how you want to run BER:
-
Create a GitHub App by following our documentation guide. This will provide you with the required credentials for the next steps.
-
Set the environment variables
export GH_APP_ID=""
export GH_PRIVATE_KEY="" # base64 decoded pem
export GH_WEBHOOK_SECRET=""
export OPENAI_API_KEY=""
- Start ngrok:
ngrok http http://localhost:8080
- Run the application:
go run . webhook --debug
For detailed GitHub adapter usage instructions, please visit our GitHub Adapter Tutorial.
- Set the environment variable
export OPENAI_API_KEY=""
- Run the TUI:
go run . tui
Now that you have the environment set up, you're ready to build your first BERAgent! Check out our Agent Building Tutorial to get started with creating custom agents for your specific use cases.
- Adapters:
- Jira
- Slack
- Teams
- GitHub improvements - PR, code, discussions
- Core:
- Improving Agent selection
- Skill Chaining
- Collaborating Agents
- Adapter and Agent separation from core
- Long-term memory
- Multi tenancy
- Session separations for chat adapters
Any contributions you make are greatly appreciated. We would love to hear your feedback - feel free to open a new discussion!
Please read our Contributing Guidelines for details on our code of conduct, and the process for submitting pull requests.
We take security seriously. If you believe you have found a security vulnerability, please report it to us as described in our Security Policy.
This project and everyone participating in it is governed by our Code of Conduct. By participating, you are expected to uphold this code.
Distributed under the Apache-2.0 license. See LICENSE.txt
for more information.
- BER - github@ber.run
- Project Link: https://github.com/berbyte/ber-os
- Documentation: https://rtfm.ber.run