{"id":37476692,"url":"https://github.com/smarter-sh/smarter","last_synced_at":"2026-05-30T02:05:17.091Z","repository":{"id":316960893,"uuid":"754367022","full_name":"smarter-sh/smarter","owner":"smarter-sh","description":"Smarter is an extensible AI authoring and resource management system","archived":false,"fork":false,"pushed_at":"2026-04-15T23:26:35.000Z","size":83916,"stargazers_count":3,"open_issues_count":21,"forks_count":23,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-04-16T01:28:23.357Z","etag":null,"topics":["ai","data-science","django","drf","full-stack","llm","pydantic","python","toolcalling"],"latest_commit_sha":null,"homepage":"https://smarter.sh/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/smarter-sh.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"lpm0073","patreon":"lpm0073"}},"created_at":"2024-02-07T22:46:04.000Z","updated_at":"2026-04-15T23:26:00.000Z","dependencies_parsed_at":"2025-09-27T22:25:40.593Z","dependency_job_id":null,"html_url":"https://github.com/smarter-sh/smarter","commit_stats":null,"previous_names":["smarter-sh/smarter"],"tags_count":281,"template":false,"template_full_name":null,"purl":"pkg:github/smarter-sh/smarter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smarter-sh%2Fsmarter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smarter-sh%2Fsmarter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smarter-sh%2Fsmarter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smarter-sh%2Fsmarter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smarter-sh","download_url":"https://codeload.github.com/smarter-sh/smarter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smarter-sh%2Fsmarter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32025786,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","data-science","django","drf","full-stack","llm","pydantic","python","toolcalling"],"created_at":"2026-01-16T07:22:20.785Z","updated_at":"2026-05-30T02:05:17.085Z","avatar_url":"https://github.com/smarter-sh.png","language":"JavaScript","funding_links":["https://github.com/sponsors/lpm0073","https://patreon.com/lpm0073"],"categories":[],"sub_categories":[],"readme":"# The Smarter Project\n\n[![Latest Release](https://img.shields.io/github/v/release/smarter-sh/smarter?label=release)](https://github.com/smarter-sh/smarter/releases)\n![Build Status](https://github.com/smarter-sh/smarter/actions/workflows/build.yml/badge.svg?branch=main)\n![Release Status](https://github.com/smarter-sh/smarter/actions/workflows/deploy.yml/badge.svg?branch=main)\n[![Documentation Status](https://readthedocs.org/projects/smarter/badge/?version=latest)](https://docs.smarter.sh/)\n[![Docker Pulls](https://img.shields.io/docker/pulls/mcdaniel0073/smarter.svg?logo=docker\u0026label=DockerHub)](https://hub.docker.com/r/mcdaniel0073/smarter)\n[![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/project-smarter)](https://artifacthub.io/packages/search?repo=project-smarter)\u003cbr\u003e[![Docs](https://img.shields.io/badge/Read%20the%20Docs-smarter.sh-blue?logo=readthedocs)](https://docs.smarter.sh/en/latest/)\n[![Website](https://img.shields.io/badge/official%20web%20site-smarter.sh-blue?logo=google-chrome)](https://smarter.sh)\n[![License: GNU AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)\u003cbr\u003e[![Python](https://img.shields.io/badge/Python-3.13-blue?logo=python)](https://www.python.org/)\n[![Django](https://img.shields.io/badge/Django-5.2-green?logo=django)](https://www.djangoproject.com/)\n[![Pydantic](https://img.shields.io/badge/Pydantic-2.12-blue?logo=pydantic)](https://docs.pydantic.dev/)\n[![Django Rest Framework](https://img.shields.io/badge/Django%20Rest%20Framework-3.16-3a3a3a?logo=django)](https://www.django-rest-framework.org/)\u003cbr\u003e[![hack.d Lawrence McDaniel](https://img.shields.io/badge/Author-Lawrence%20McDaniel-orange.svg)](https://lawrencemcdaniel.com)\n\nThis repo contains source code for the Smarter REST API and the web based\nauthoring platform.\n\nSmarter is a declarative extensible AI authoring and resource management system.\nIt is used as an instructional tool at [University of British Columbia](https://www.ubc.ca/)\nfor teaching cloud computing at scale, and generative AI prompt engineering\ntechniques including advanced use of LLM tool calling involving secure\nintegrations to remote data sources like Sql databases and remote APIs.\n\n## At a Glance\n\n- [1-click Quickstart](https://github.com/smarter-sh/smarter-deploy) deployment with Docker.\n- declarative manifest based resource management\n- no-code LLM tool call extensibility that facilitates integrations to remote data sources like Sql databases and remote APIs\n- [command-line interface](https://smarter.sh/cli) for Windows, macOS, Linux and Docker\n- [rest api](https://platform.smarter.sh/docs/swagger/)\n- web console / prompt engineer workbench\n- robust developer ecosystem: [PyPi](https://github.com/smarter-sh/smarter-python), [NPM](https://www.npmjs.com/package/@smarter.sh/ui-chat), [VS Code Extension](https://marketplace.visualstudio.com/items?itemName=querium.smarter-manifest) and more\n- publicly accessible [online documentation](https://platform.smarter.sh/docs/) and self onboarding resources\n- open source UI components for jump starting projects\n\n## Quickstart\n\nThis setup uses Docker and takes around 20 minutes for first time installations.\n\n1. Verify project requirements:\n\n   - Windows, macOS, Linux operating system\n   - 20Gib disk storage capacity\n   - 4Gib system memory\n   - [Python 3.13](https://www.python.org/)\n   - [Docker](https://www.docker.com/products/docker-desktop/),\n   - [Docker Compose](https://docs.docker.com/compose/install/).\n\n2. Add your credentials to [.env](./.env.example) in the root of this repo.\n   See the inline documentation for details on the minimum environment variables\n   that you will need to set.\n\n3. Initialize, build and run the application locally.\n\n```console\ngit clone https://github.com/smarter-sh/smarter\nmake help           # scaffolds a .env file in the root of the repo\n                    #\n                    # ****************************\n                    # STOP HERE!\n                    # ****************************\n                    # Add your credentials to .env located in the project root folder.\n                    #\nmake init           # pulls Docker containers, creates a Python virtual environment,\n                    # installs all packages, creates and initializes a\n                    # local MySql database, preloads example AI resources\nmake run            # runs all docker containers and starts a\n                    # local web server http://localhost:9357/\n```\n\n4. Login at http://localhost:9357/login/ with user `admin@smarter.sh` and password `smarter`.\n\nSee these onboarding videos:\n\n- [Smarter Developer Onboarding I](https://youtu.be/-hZEO9sMm1s)\n- [Smarter Developer Onboarding II](https://www.youtube.com/watch?v=G2RSCzxxupE)\n- [Smarter Developer Workflow Tutorial](https://youtu.be/XolFLX1u9Kg)\n\n## Key Features\n\n**Smarter** implements a yaml manifest-based approach to managing AI resources that is inspired by the [Kubernetes](https://kubernetes.io/) project.\n\nIt provides a unified, declarative way to define, configure, and orchestrate the disparate resources that are required for creating and managing AI resources that integrate to other enterprise resources like REST API's and Sql databases. And it gives prompt engineering teams an intuitive workbench approach to designing, prototyping, testing, deploying and managing powerful AI resources for common corporate use cases including agentic workflows, customer facing chat solutions, and more. It includes a separately managed [React-based chat UI](https://github.com/smarter-sh/smarter-chat) that is compatible with a wide variety of front end ecosystems including NPM, Wordpress, Squarespace, Drupal, Office 365, Sharepoint, .Net, Netsuite, salesforce.com, and SAP. There is a [Golang command-line interface](https://github.com/smarter-sh/smarter-cli), and a [PyPi package](https://github.com/smarter-sh/smarter-python) for integrating the API functions into your own Python projects. It is developed to support prompt engineering teams working in large organizations. Accordingly, **Smarter** provides common enterprise features such as credentials management, team workgroup management, role-based security, accounting cost codes, and logging and audit capabilities.\n\n**Smarter** provides seamless integration and interoperation between LLMs from DeepSeek, Google AI, Meta AI and OpenAI. It is LLM provider-agnostic, and provides seamless integrations to a continuously evolving list of value added services for security management, prompt content moderation, audit, cost accounting, and workflow management. **Smarter** is cloud native and runs on Kubernetes, on-site in your data center or in the cloud.\n\n**Smarter** is cost effective when running at scale. It is extensible and architected on the philosophy of a compact core that does not require customization nor forking. It is horizontally scalable. It is natively multi-tenant, and can be installed alongside your existing systems. ## Quickstart\n\n## Smarter Helm Chart\n\nDeploy Smarter API and web console to Kubernetes using the public Helm chart, available at [ghcr.io/smarter-sh/charts/smarter](https://ghcr.io/smarter-sh/charts/smarter) or [Artifact Hub](https://artifacthub.io/packages/helm/project-smarter/smarter).\n\n### Quick Install\n\nPull the chart:\n\n```console\nhelm pull oci://ghcr.io/smarter-sh/charts/smarter --version 0.7.6\n```\n\nInstall to Kubernetes:\n\n```console\nhelm upgrade --install smarter oci://ghcr.io/smarter-sh/charts/smarter \\\n  --namespace smarter \\\n  --create-namespace \\\n  --timeout 900s \\\n  --values values.yaml\n```\n\n### Configuration\n\nSee the [chart values.yaml](./helm/charts/smarter/values.yaml) for all available parameters, or view the [chart README](./helm/charts/smarter/README.md) for detailed configuration examples.\n\nMinimum required configuration in your `values.yaml`:\n\n```yaml\nenv:\n  MYSQL_HOST: \"your-mysql-host\"\n  MYSQL_DATABASE: \"smarter\"\n  MYSQL_USER: \"smarter_user\"\n  MYSQL_PASSWORD: \"your-secure-password\"\n  OPENAI_API_KEY: \"sk-...\"\n  SECRET_KEY: \"your-django-secret-key\"\n\n  # Deployment\n  DJANGO_SETTINGS_MODULE: \"${{ env.DJANGO_SETTINGS_MODULE }}\"\n  ENVIRONMENT: \"${{ inputs.environment }}\"\n  NAMESPACE: \"${{ env.NAMESPACE }}\"\n  SMARTER_DOCKER_IMAGE: \"${{ env.SMARTER_DOCKER_IMAGE }}\"\n\n  # AWS\n  AWS_REGION: \"${{ inputs.aws-region }}\"\n  AWS_ACCESS_KEY_ID: \"${{ inputs.aws-access-key-id }}\"\n  AWS_SECRET_ACCESS_KEY: \"${{ inputs.aws-secret-access-key }}\"\n\n  # Security\n  FERNET_ENCRYPTION_KEY: \"${{ inputs.fernet-encryption-key }}\"\n  SECRET_KEY: \"${{ env.SECRET_KEY }}\"\n\n  # AI APIs\n  OPENAI_API_KEY: \"${{ inputs.openai-api-key }}\"\n  GOOGLE_MAPS_API_KEY: \"${{ inputs.google-maps-api-key }}\"\n  GEMINI_API_KEY: \"${{ inputs.gemini-api-key }}\"\n  LLAMA_API_KEY: \"${{ inputs.llama-api-key }}\"\n\n  # Database\n  MYSQL_HOST: \"${{ env.MYSQL_HOST }}\"\n  MYSQL_PORT: \"${{ env.MYSQL_PORT }}\"\n  MYSQL_DATABASE: \"${{ env.SMARTER_MYSQL_DATABASE }}\"\n  MYSQL_USER: \"${{ env.SMARTER_MYSQL_USERNAME }}\"\n  MYSQL_PASSWORD: \"${{ env.SMARTER_MYSQL_PASSWORD }}\"\n  MYSQL_ROOT_USERNAME: \"${{ env.MYSQL_ROOT_USERNAME }}\"\n  MYSQL_ROOT_PASSWORD: \"${{ env.MYSQL_ROOT_PASSWORD }}\"\n  SMARTER_MYSQL_TEST_DATABASE_PASSWORD: \"${{ inputs.smarter-mysql-test_database_password }}\"\n\n  # Admin\n  SMARTER_LOGIN_URL: \"${{ env.SMARTER_LOGIN_URL }}\"\n  SMARTER_ADMIN_PASSWORD: \"${{ env.SMARTER_ADMIN_PASSWORD }}\"\n  SMARTER_ADMIN_USERNAME: \"${{ env.SMARTER_ADMIN_USERNAME }}\"\n  SMARTER_ADMIN_EMAIL: \"${{ env.SMARTER_ADMIN_EMAIL }}\"\n\n  # SMTP\n  SMTP_HOST: \"${{ env.SMTP_HOST }}\"\n  SMTP_PORT: \"${{ env.SMTP_PORT }}\"\n  SMTP_USE_SSL: \"${{ env.SMTP_USE_SSL }}\"\n  SMTP_USE_TLS: \"${{ env.SMTP_USE_TLS }}\"\n  SMTP_USERNAME: \"${{ env.SMTP_USERNAME }}\"\n  SMTP_PASSWORD: \"${{ env.SMTP_PASSWORD }}\"\n```\n\n## Documentation\n\nDetailed documentation for this repo is available here: [docs.smarter.sh](https://docs.smarter.sh/)\n\n## Support\n\nPlease report bugs to the [GitHub Issues Page](https://github.com/smarter-sh/smarter/issues) for this project.\n\n## Contributing\n\nPlease see the [CONTRIBUTING](https://docs.smarter.sh/en/latest/smarter-framework/guides/contributing.html).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmarter-sh%2Fsmarter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmarter-sh%2Fsmarter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmarter-sh%2Fsmarter/lists"}