Skip to content
/ ber-os Public

🐻 BER is an open-source framework that connects the tools you already use to manage your processes with other systems you still handle manually, using natural language to automate workflows. Apache 2.0 licensed.

License

Notifications You must be signed in to change notification settings

berbyte/ber-os

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

20 Commits
Β 
Β 
Β 
Β 
Β 
Β 

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.

Give Feedback

BER: LLM SuperGlue

BER: LLM SuperGlue v0.1

Explore the docs Β»

View Demo Β· Report a Bug Β· Quickstart Guide

What is this all about?

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.

Why BER?

  • πŸ›‘ 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.

Demo

πŸ’‘ See how BER simplifies DNS management directly through GitHub Issues; one of many powerful use cases:

BER Demo

Tip

Want to see BER in action?

Check out our use cases documentation to explore examples of how BER can help you.

Key Features

  • 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.

High-Level Diagram

πŸ’‘ 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!

(back to top)

Available Agents

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.

(back to top)

Getting Started

  1. Clone the repository:
git clone git@github.com:berbyte/ber-os.git
cd ber-os
  1. Install the dependencies:
go mod tidy

You can now decide how you want to run BER:

Running BER as a GitHub Application

  1. Create a GitHub App by following our documentation guide. This will provide you with the required credentials for the next steps.

  2. Set the environment variables

export GH_APP_ID=""
export GH_PRIVATE_KEY="" # base64 decoded pem
export GH_WEBHOOK_SECRET=""

export OPENAI_API_KEY=""
  1. Start ngrok:
ngrok http http://localhost:8080
  1. Run the application:
go run . webhook --debug

For detailed GitHub adapter usage instructions, please visit our GitHub Adapter Tutorial.

Running BER as a Terminal User Interface

‼️ The TUI adapter is currently in an experimental state. ‼️

  1. Set the environment variable
export OPENAI_API_KEY=""
  1. Run the TUI:
go run . tui

Final Step: Build Your Own Agents

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.

(back to top)

Public Roadmap

  • 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

(back to top)

Contributing

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.

Security

We take security seriously. If you believe you have found a security vulnerability, please report it to us as described in our Security Policy.

Code of Conduct

This project and everyone participating in it is governed by our Code of Conduct. By participating, you are expected to uphold this code.

License

Distributed under the Apache-2.0 license. See LICENSE.txt for more information.

Contact

(back to top)

About

🐻 BER is an open-source framework that connects the tools you already use to manage your processes with other systems you still handle manually, using natural language to automate workflows. Apache 2.0 licensed.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project