{"id":24478810,"url":"https://github.com/1159-accelerators/nebula","last_synced_at":"2025-04-13T14:20:45.797Z","repository":{"id":257874951,"uuid":"839080526","full_name":"1159-accelerators/nebula","owner":"1159-accelerators","description":"Contextual document chat using AWS native services","archived":false,"fork":false,"pushed_at":"2024-10-15T16:10:30.000Z","size":2622,"stargazers_count":15,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2024-10-16T21:07:11.830Z","etag":null,"topics":["aws","bedrock","quasar-framework"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/1159-accelerators.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-06T23:45:08.000Z","updated_at":"2024-10-04T17:19:19.000Z","dependencies_parsed_at":"2024-10-16T21:07:24.744Z","dependency_job_id":"661baeda-3304-4c53-80a3-e6e727fb75f9","html_url":"https://github.com/1159-accelerators/nebula","commit_stats":null,"previous_names":["1159-accelerators/nebula"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1159-accelerators%2Fnebula","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1159-accelerators%2Fnebula/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1159-accelerators%2Fnebula/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1159-accelerators%2Fnebula/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/1159-accelerators","download_url":"https://codeload.github.com/1159-accelerators/nebula/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248725091,"owners_count":21151626,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["aws","bedrock","quasar-framework"],"created_at":"2025-01-21T10:13:39.246Z","updated_at":"2025-04-13T14:20:45.788Z","avatar_url":"https://github.com/1159-accelerators.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nebula Knowledge Base\nWelcome to the Nebula Knowledge Base, which provides contextual chat capabilities to help you query and understand your enterprise documents effectively. \nWith deployment made simple through CloudFormation, you can get started in just a few clicks. \nIt is fully contained within your environment, ensuring that your data remains secure at all times.\n\n\n## Deploying the Stack\nThe application can be deployed by simply clicking `Deploy the Stack` below. This link will take you directly to the CloudFormation console with the proper template preloaded.  \n  \nDue to origin limitations around lambda zip files delivered using S3, Nebula can only be deployed in the following regions. If you require deploying to a region not on the list, just let us know at \naccelerators@1159.ai  \n\n- US-EAST-1\n- US-WEST-2\n- CA-CENTRAL-1\n\nBecause Nebula uses Bedrock Knowledge Bases under the hood, it's currently limited to the following file types:\n- Plain text (txt)\n- Markdown (md)\n- HyperText Markup Language (html)\n- Microsoft Word document (doc/docx)\n- Comma-separated values (csv)\n- Microsoft Excel spreadsheet (xls/xlsx)\n- Portable Document (pdf)\n\nOnce the stack creation is complete, the output `WebUrl` can be found in the Output tab within CloudFormation. Following this link should take you to the application \nand you can login with the temporary password that was sent to the user email provided during deployment\n\n**Note: You must have access to the chosen models BEFORE deploying this application.** To gain access to the necessary models, please reference \n[Manage access to Amazon Bedrock foundation models](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html) in the Bedrock User Guide  \n\n**[Deploy the Stack](https://console.aws.amazon.com/cloudformation/home?#/stacks/new?stackName=Nebula-1159\u0026templateURL=https://1159-public-assets.s3.amazonaws.com/nebula/1.4.0/template.json)**\n\n#### CloudFormation Parameters\n##### User Email\nThis will be used to create the initial Cognito user and a temporary password \nwill be sent to this address during the deployment\n\n##### Upload Sample Documents\nDon't worry, it's just a couple of documents about [11:59](https://1159.ai), so storage consumption\nshould not be an issue\n\n##### Embedding Model\nThese are the embeddings models available to choose:\n- amazon.titan-embed-text-v1\n- **amazon.titan-embed-text-v2:0**\n- cohere.embed-english-v3\n- cohere.embed-multilingual-v3\n\n##### Foundation Model\nThese are the LLMs available to choose:\n- amazon.titan-text-premier-v1:0\n- anthropic.claude-v2\n- anthropic.claude-v2:1\n- **anthropic.claude-3-sonnet-20240229-v1:0**\n- anthropic.claude-3-haiku-20240307-v1:0\n- anthropic.claude-instant-v1\n\n## Component Details\n#### Backend\n- [API Gateway](https://aws.amazon.com/api-gateway/)\n- [Bedrock](https://aws.amazon.com/bedrock/)\n- [CloudFront](https://aws.amazon.com/cloudfront/)\n- [Cognito](https://aws.amazon.com/cognito/)\n- [Lambda](https://aws.amazon.com/lambda/)\n- [OpenSearch](https://aws.amazon.com/opensearch-service/)\n- [S3](https://aws.amazon.com/s3/)\n\n#### Frontend\n- [Quasar Framework](https://quasar.dev/)\n- [Vue.js](https://vuejs.org/)\n\n#### Architecture\n![Architeture Diagram](/client/public/diagram.png \"Architecture Diagram\")\n\n## Building Your Own\n#### Install the Prerequisites\n- [AWS CDK](https://docs.aws.amazon.com/cdk/v2/guide/getting_started.html)\n- [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)\n- [Node.js](https://nodejs.org/en/download/package-manager)\n\n#### Create an AWS CLI Profile\nNebula uses AWS profiles in order to authenticate to AWS, and, by default, the profile is named `shared-services`. \nIf you have a different name for your profile you must change all references to `shared-services` in \nthe top-level `package.json` file.\n\n#### Create or Set the Source Bucket\nWe designed Nebula to be deployable using nothing but a CloudFormation link, and because of that, \nall artifacts are built and then uploaded to an S3 bucket for distribution. We're using a bucket called \n`1159-public-assets` which obviously needs to be changed to your chosen bucket. References to the bucket \nare located in the following files:\n- package.json\n- lib/nebula-stack.ts\n\n#### Build the App\nAfter you've installed the prerequisites, set your AWS profile, and created the source bucket you can simply run \n`npm run build` to build the application. This is a cascading command that kicks off multiple other tasks in the `package.json` file.\n1. Compiles the TypeScript lambdas using [esbuild](https://esbuild.github.io/)\n2. Compiles the Quasar client\n3. Archives the lambdas into zip files\n4. Synthesizes the CDK project to CloudFormation\n5. Uploads the CF templates, client assets, lambdas, and sample data to the source bucket\n\nAfter the build is complete, you should find the final CloudFormation file in your source bucket \nat `nebula/{version}/template.json`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1159-accelerators%2Fnebula","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F1159-accelerators%2Fnebula","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1159-accelerators%2Fnebula/lists"}