aitomatic / openssa Goto Github PK

View Code? Open in Web Editor NEW

188.0 17.0 29.0 37.66 MB

OpenSSA: Small Specialist Agents—Enabling Efficient, Domain-Specific Planning + Reasoning for AI

Home Page: https://aitomatic.github.io/openssa/

License: Other

Python 97.93% Makefile 1.35% Batchfile 0.72%

domain-knowledge industrial-ai small-models specialist-agents

openssa's Introduction

`OpenSSA`: Small Specialist Agents for Problem-Solving

OpenSSA is an agentic AI framework for solving complex problems in real-world industry domains, overcoming the limitations of LLMs and RAG in such settings.

Level-2 Intelligence with Planning, Reasoning, domain-specific Knowledge and diverse Resources

OpenSSA agents, built with powerful Hierarchical Task Planning (HTP) and Observe-Orient-Decide-Act Reasoning (OODAR), go far beyond the Level-1 pattern-matching intelligence performed by LLMs and RAG and achieve superior outcomes in complex multi-faceted, multi-step tasks. See our comparative study.

OpenSSA agents can also be armed with domain-specific Knowledge, connected to diverse Resources (files, databases, web sources, etc.), and/or be guided by specialized industry experts to maximize the accuracy and comprehensiveness in their planning, reasoning and deliberative/iterative problem-solving.

Open and Extensible Architecture

Committed to promoting and supporting open development in generative AI, OpenSSA would strive to integrate with a diverse array of LLM backends, especially open-source LLMs. If you would like certain LLMs to be supported, please suggest through a GitHub issue, or, even better, submit your PRs.

Additionally, OpenSSA's key Planning, Reasoning, Knowledge and Resource interfaces are designed with customizability and extensibility as first-class concerns, in order to enable developers to effectively solve problems in their specific industries and specialized domains.

Small and Resource-Efficient Agents for Practical Real-World Deployment

Specialized, Level-2 intelligence allows OpenSSA agents to work well in many applications using significantly smaller component models, thereby greatly economizing computing resources.

Getting Started

Install by pip install openssa (on Python 3.12 only).

for bleeding-edge latest capabilities: pip install https://github.com/aitomatic/openssa/archive/main.zip

Explore the examples/ directory and developer guides and tutorials on our documentation site.

API Documentation

Contributing

We welcome contributions from the community!

Join the discussion on our Community Forum
Submit pull requests for bug fixes, enhancements, or new features

For more information, see our Contribution Guide.

openssa's People

Contributors

Stargazers

Watchers

openssa's Issues

How do I run ChatSSM and the openai.ipynb?

This appears to be an outdated example, @TheVinhLuong102 .

Discussed in #25

^{Originally posted by mikheladam October 23, 2023}
Greetings!

I am a beginner exploring AI so my technical skills are still in development. I have some problem running the openai.ipynb and the chatssm example. For the openai.ipynb, I've set my API key but when i try to run it, I get an error. Below is the code and corresponding error.

Code:
ssm.discuss("Remember, my name is CTN. I am a chatbot."), I get this error

Error:
InvalidRequestError: Must provide an 'engine' or 'model' parameter to create a <class 'openai.api_resources.chat_completion.ChatCompletion'>

I'm not sure where to put the parameter mentioned in the error.

Another error I'm getting is when I run the chatssm example and try to enter a prompt, I get the following reply:
"SYSTEM: HTTP error status: 500"

I can't find anything in the documentation that may help solve these. Apologies if these are very basic questions or if I've missed an important obvious step. Any help would be much appreciated.

Screenshots

Desktop (please complete the following information):
N/A

Smartphone (please complete the following information):
N/A