GitHub 1C Enterprise Daily Trending

PWhiddy/PokemonRedExperiments

2023-10-16T01:24:17Z

🚀🧠💬 Supercharged Custom Instructions for ChatGPT (non-coding) and ChatGPT Advanced Data Analysis (coding).

ChatGPT AutoExpert

by Dustin Miller • Reddit • Substack

License: Attribution-NonCommercial-ShareAlike 4.0 International

Elevating Conversational AI to Expert Level

Want to support these free prompts? My Substack offers paid subscriptions, that's the best way to show your appreciation.

Introduction

ChatGPT AutoExpert is a shockingly effective set of custom instructions aimed at enhancing the capabilities of GPT-4 and GPT-3.5-Turbo conversational models. These instructions maximize the depth and nuance in responses while minimizing general disclaimers and hand-holding. The ultimate objective is to provide users with accurate, context-rich information and an improved learning experience.

Getting Started

To get started with ChatGPT AutoExpert, choose which set of custom instructions you want to use:

AutoExpert ("Standard Edition")
(for non-coding tasks)
AutoExpert ("Developer Edition")
(requires GPT-4 with Advanced Data Analysis)

Features

"Standard Edition"

✳️ New to v5: Automatically Improves your Question
Many of us still compose ambiguous questions when asking ChatGPT for help. The AutoExpert will automatically rewrite your question to be precise, and to elicit the best response the experts can provide.
✳️ New to v5: Slash Commands
Slash commands offer an easy way to interact with the AutoExpert system. Get summaries, ideas for additional questions, alternative viewpoints…even ask ChatGPT to review its own answer and suggest improvements.
✳️ New to v5: Auto-selects Frameworks and Methodologies
Designed to select a context-appropriate framework for formulating its best answers
Maximized Depth and Nuance
Receive high-quality, in-depth, and ✳️ New to v5: multi-turn responses (GPT-4 only) without compromising on the granularity of the information.
Perfect for Everyday Use
No need to switch these instructions on and off. They'll give you a greatly improved experience with ChatGPT, even if you're writing code. Although, if you are writing code, you should check the Developer Edition
Automatically Identifies the Best Expert
The AutoExpert custom instruction automatically finds the best expert roles to answer whatever question you ask, every time. You don't need a bunch of special prompts any more—this works with even the simplest of prompts!
Minimized Hand-Holding
Cut through the noise and get straight to the facts, reducing unnecessary disclaimers.
Explicit Reasoning
Your AutoExpert doesn't just provide answers; it offers an explanation, detailing the thought process behind each response.
Resourceful Links
Automatically generates inline links for related topics and "you may also like" topics, helpfully linked to Google search results to avoid hallucination (GPT-3.5 still hallucinates here, but not always. GPT-4 is rock-solid).

"Developer Edition"

[!IMPORTANT] This requires a ChatGPT professional subscription, as it needs both GPT-4 and Advanced Data Analysis!

Verbosity Selection
Easily choose the complexity of the generated code, from compact "code golf" type responses, up to complex, modular code samples
Powered by Jupyter
ChatGPT Advanced Data Analysis already runs a Jupyter kernel under the hood. AutoExpert (Developer Edition) comes with a companion Python script that you simply upload to your conversation. It will automatically take advantage of the sandbox Python environment for editing longer code samples, and activate a handful of extra "slash commands" to make your life even easier.
Pick Up Where You Left Off
You can start a new chat without worrying about ChatGPT forgetting what you were doing in the previous one. The /memory slash command will download all your files, and a history of everything that's been done during your session. Simply upload it (along with the companion script) in a new session, and pick up where you left off.
Install Custom Wheels
Yeah, you heard me. Wheels for Python packages can be uploaded and installed automatically.
- Note that your ChatGPT sandbox uses Python 3.8, on a VM with x86_64 architecture (as of this writing).
Save Your Work
Among other /slash commands, AutoExpert (Developer Edition) will save all your code snippets, dehydrate its memory of your requirements and the work it's done—even back up the code cells themselves. Then it zips it up, and you can quickly download your coding conversation history.
File and Symbol Tree
By keeping a running history along with a file/symbol tree at the end of each response, ChatGPT will always remember what it just did, and you'll always see what files still need work. It's even smart enough to handle breaking down complex requirements in a way that allows it to write code over multiple turns.

ChatGPT AutoExpert (both standard and "Developer Edition")
by Dustin Miller is licensed under Attribution-NonCommercial-ShareAlike 4.0 International

iam-veeramalla/python-for-devops

2023-10-16T01:24:17Z

Learn Python from DevOps Engineer point of you.

Python Zero to Hero for DevOps Engineers

Day 1: Introduction to Python, Installation, and Configuration

Introduction to Python and its role in DevOps.
Installing Python and setting up a development environment.
Writing your first Python program.

Day 2: Working with Strings and Numbers

String data type in Python.
String manipulation and formatting.
Regular expressions for text processing.
Numeric data types in Python (int, float).

Day 3: Variables

Understanding variables in Python.
Variable scope and lifetime.
Variable naming conventions and best practices.
Practice exercises and examples:
- Example: Using variables to store and manipulate configuration data in a DevOps context.

Day 4: Functions, Modules and Packages

What are differences between function, modules and packages ?
How to import a package ?
What are Python workspaces ?

Day 5: Environment Variables and Command Line Arguments

Reading and writing environment variables in Python.
Using the os and dotenv modules.
Securing sensitive information in environment variables.
Handling command line arguments in Python.
Practice exercises and examples:
- Example: Developing a Python script that accepts command line arguments to customize DevOps automation tasks.

Day 6: Operators

Introduction to operators in Python.
Arithmetic, comparison, and logical operators.
Bitwise and assignment operators.
Practice exercises and examples:
- Example: Using operators to perform calculations and comparisons in a DevOps script.

Day 7: Conditional Handling using if, elif and else

Conditional statements (if, elif, else).
Practice exercises and examples:
- Example: Automating a server shutdown if it's running out of disk space.

Day 8: Working with Lists (Part 1)

Understanding lists and list data structure.
List manipulation and common list operations.
Practice exercises and examples:
- Example: Writing a script to manage a list of user accounts in a DevOps environment.

Day 9: Loops

Loops in Python (for and while).
Loop control statements (break, continue).
Practice exercises and examples:
- Example: Automating a log file analysis with a loop to find errors.

Day 10: Working with Lists (Part 2)

List comprehensions.
Nested lists and advanced list operations.
Practice exercises and examples:
- Example: Parsing a complex configuration file with nested lists.

Day 11: Working with Dictionaries and Sets

Dictionaries and key-value pairs.
Sets and set operations.
Practice exercises and examples:
- Example: Managing a dictionary of server configurations and optimizing retrieval.

Day 12: Functions and Modules

Introduction to functions in Python.
Writing functions and function parameters.
Return values and modular code.
Practice exercises and examples:
- Example: Creating a function to automate server status checks.

Day 13: Functions and Modules (Part 2)

Advanced function topics (recursion, lambda functions).
Function libraries and built-in functions.
Practice exercises and examples:
- Example: Developing a library of custom functions for DevOps automation.

Day 14: Python Libraries for DevOps (Part 1)

Introduction to external libraries like Paramiko, Fabric, and Boto3.
Automating SSH connections with Paramiko.
Running commands on remote servers.
Practice exercises and examples:
- Example: Using Paramiko to create a secure remote backup solution.

Day 15: Python Libraries for DevOps (Part 2)

Using Fabric for remote task automation.
AWS automation with Boto3.
Managing EC2 instances, S3 buckets, and more.
Practice exercises and examples:
- Example: Creating a Fabric script for deploying applications to remote servers.

Day 16: Working with RESTful APIs

Introduction to RESTful APIs.
Making HTTP requests using Python.
Parsing JSON responses and error handling.
Practice exercises and examples:
- Example: Developing a script to monitor RESTful API endpoints for your DevOps tools.

Day 17: Data Serialization and Configuration Files

Serializing and deserializing data (JSON, YAML).
Managing configuration data.
DevOps use cases for configuration files.
Practice exercises and examples:
- Example: Building a configuration manager to handle application settings in JSON format.

Day 18: Automation with Cron Jobs

Scheduling automated tasks using cron.
Creating Python scripts for scheduled automation.
Handling periodic tasks and reports.
Practice exercises and examples:
- Example: Using cron and Python to schedule regular backups of your data.

Day 19: Python Interview Questions & Answers

adrianhajdin/travel_ui_ux

2023-10-16T01:24:17Z

Self-hosted game stream host for Moonlight.

Overview

LizardByte has the full documentation hosted on Read the Docs <https://sunshinestream.readthedocs.io/>__.

About

Sunshine is a self-hosted game stream host for Moonlight. Offering low latency, cloud gaming server capabilities with support for AMD, Intel, and Nvidia GPUs for hardware encoding. Software encoding is also available. You can connect to Sunshine from any Moonlight client on a variety of devices. A web UI is provided to allow configuration, and client pairing, from your favorite web browser. Pair from the local server or any mobile device.

System Requirements

.. warning:: This table is a work in progress. Do not purchase hardware based on this.

Minimum Requirements

+------------+------------------------------------------------------------+ | GPU | AMD: VCE 1.0 or higher, see obs-amd hardware support_ | | +------------------------------------------------------------+ | | Intel: VAAPI-compatible, see: VAAPI hardware support_ | | +------------------------------------------------------------+ | | Nvidia: NVENC enabled cards, see nvenc support matrix_ | +------------+------------------------------------------------------------+ | CPU | AMD: Ryzen 3 or higher | | +------------------------------------------------------------+ | | Intel: Core i3 or higher | +------------+------------------------------------------------------------+ | RAM | 4GB or more | +------------+------------------------------------------------------------+ | OS | Windows: 10+ (Windows Server not supported) | | +------------------------------------------------------------+ | | macOS: 11.7+ | | +------------------------------------------------------------+ | | Linux/Debian: 11 (bullseye) | | +------------------------------------------------------------+ | | Linux/Fedora: 36+ | | +------------------------------------------------------------+ | | Linux/Ubuntu: 20.04+ (focal) | +------------+------------------------------------------------------------+ | Network | Host: 5GHz, 802.11ac | | +------------------------------------------------------------+ | | Client: 5GHz, 802.11ac | +------------+------------------------------------------------------------+

4k Suggestions

+------------+------------------------------------------------------------+ | GPU | AMD: Video Coding Engine 3.1 or higher | | +------------------------------------------------------------+ | | Intel: HD Graphics 510 or higher | | +------------------------------------------------------------+ | | Nvidia: GeForce GTX 1080 or higher | +------------+------------------------------------------------------------+ | CPU | AMD: Ryzen 5 or higher | | +------------------------------------------------------------+ | | Intel: Core i5 or higher | +------------+------------------------------------------------------------+ | Network | Host: CAT5e ethernet or better | | +------------------------------------------------------------+ | | Client: CAT5e ethernet or better | +------------+------------------------------------------------------------+

HDR Suggestions

+------------+------------------------------------------------------------+ | GPU | AMD: Video Coding Engine 3.4 or higher | | +------------------------------------------------------------+ | | Intel: UHD Graphics 730 or higher | | +------------------------------------------------------------+ | | Nvidia: Pascal-based GPU (GTX 10-series) or higher | +------------+------------------------------------------------------------+ | CPU | AMD: todo | | +------------------------------------------------------------+ | | Intel: todo | +------------+------------------------------------------------------------+ | Network | Host: CAT5e ethernet or better | | +------------------------------------------------------------+ | | Client: CAT5e ethernet or better | +------------+------------------------------------------------------------+

Integrations

.. image:: https://img.shields.io/github/actions/workflow/status/lizardbyte/sunshine/CI.yml.svg?branch=master&label=CI%20build&logo=github&style=for-the-badge :alt: GitHub Workflow Status (CI) :target: https://github.com/LizardByte/Sunshine/actions/workflows/CI.yml?query=branch%3Amaster

.. image:: https://img.shields.io/github/actions/workflow/status/lizardbyte/sunshine/localize.yml.svg?branch=nightly&label=localize%20build&logo=github&style=for-the-badge :alt: GitHub Workflow Status (localize) :target: https://github.com/LizardByte/Sunshine/actions/workflows/localize.yml?query=branch%3Anightly

.. image:: https://img.shields.io/readthedocs/sunshinestream.svg?label=Docs&style=for-the-badge&logo=readthedocs :alt: Read the Docs :target: http://sunshinestream.readthedocs.io/

Support

Our support methods are listed in our LizardByte Docs <https://lizardbyte.readthedocs.io/en/latest/about/support.html>__.

Downloads

.. image:: https://img.shields.io/github/downloads/lizardbyte/sunshine/total.svg?style=for-the-badge&logo=github :alt: GitHub Releases :target: https://github.com/LizardByte/Sunshine/releases/latest

.. image:: https://img.shields.io/docker/pulls/lizardbyte/sunshine.svg?style=for-the-badge&logo=docker :alt: Docker :target: https://hub.docker.com/r/lizardbyte/sunshine

.. image:: https://img.shields.io/badge/dynamic/xml.svg?color=orange&label=Winget&style=for-the-badge&prefix=v&query=%2F%2Ftr%5B%40id%3D%27winget%27%5D%2Ftd%5B3%5D%2Fspan%2Fa&url=https%3A%2F%2Frepology.org%2Fproject%2Fsunshine%2Fversions&logo=microsoft :alt: Winget Version :target: https://github.com/microsoft/winget-pkgs/tree/master/manifests/l/LizardByte/Sunshine

Stats

.. image:: https://img.shields.io/github/stars/lizardbyte/sunshine.svg?logo=github&style=for-the-badge :alt: GitHub stars :target: https://github.com/LizardByte/Sunshine

.. _nvenc support matrix: https://developer.nvidia.com/video-encode-and-decode-gpu-support-matrix-new .. _obs-amd hardware support: https://github.com/obsproject/obs-amd-encoder/wiki/Hardware-Support .. _VAAPI hardware support: https://www.intel.com/content/www/us/en/developer/articles/technical/linuxmedia-vaapi.html

lcfd/trak

2023-10-16T01:24:51Z

Keep a record of the time you dedicate to your projects.

codiume/orbit

2023-10-17T01:25:09Z

Collection of useful integrations & components for the Astro ecosystem. ⭐️ Star to support our work!

AREA44/astro-shadcn-ui-template

2023-10-17T01:25:09Z

This template helps you build apps with Astro, Tailwind CSS, and shadcn/ui.

DiOnFire/gd-hackermode

2023-10-16T01:25:06Z

Free alternative of MegaHack v6-PRO

cjm00n/EvilSln

2023-10-16T01:25:27Z

A New Exploitation Technique for Visual Studio Projects

EvilSln: Don't open .sln files

A New Exploitation Technique for Visual Studio Projects

Background

Using code projects for phishing attacks is not a new concept. In early 2021, the Lazarus APT group employed a specific attack technique in their campaign targeting security researchers. They embedded malicious event commands within Visual Studio project files, allowing the execution of harmful code when the project is compiled, as detailed in: New campaign targeting security researchers

This incident has once again brought the security of Visual Studio into the public eye. However, it is important to note that Visual Studio is not the only product with such risks. JetBrains' IDEs, VSCode, and other text editors also face similar vulnerabilities when opening unsafe projects. As a response, these products have introduced trust zone mechanisms that disable certain risky functionalities in untrusted environments, aiming to protect their users.

In this repository, we present a new exploitation technique for Visual Studio projects (Microsoft consider it is not a security issue) and provide a proof of concept. Our intention is to raise awareness about the potential risks involved and empower individuals to avoid being hacked.

Detail Analysis

Execution

Here are some publicly disclosed methods for exploiting Visual Studio:

PreBuildEvent: Executes arbitrary commands before project compilation.

<PreBuildEvent>
    <Command>
    cmd /c calc
    </Command>
</PreBuildEvent>

GetFrameworkPaths Target: Triggered when viewing code.

<Target Name="GetFrameworkPaths">
    <Exec Command="calc.exe"/>
</Target>

COMFileReference: Triggered when loading TypeLib during project opening.

<COMFileReference Include="files\helpstringdll.tlb">
     <EmbedInteropTypes>True</EmbedInteropTypes>
</COMFileReference>

(References 2 and 3 are from https://outflank.nl/blog/2023/03/28/attacking-visual-studio-for-initial-access/. We came across this excellent article in the comments after publishing our demo video.)

We wanted to find a way to execute code without the need for compilation, simply by opening the *.sln or *.csproj project file. We discovered that after opening a project, Visual Studio automatically generates a .vs folder in the project's root directory, which contains a special binary file called .suo.

According to the Visual Studio documentation: https://learn.microsoft.com/en-us/visualstudio/extensibility/internals/solution-user-options-dot-suo-file?view=vs-2022

When the environment opens a .suo file, it enumerates all currently loaded VSPackages. If a VSPackage implements the IVsPersistSolutionOpts interface, then the environment calls the LoadUserOptions method on the VSPackage asking it to load all of its data from the .suo file.

It means that the IVsPersistSolutionOpts#LoadUserOptions function will be called when the .suo file is loaded.

By examining the VSPackage that implements OnLoadOptions, we can find VSCorePackage.

// Microsoft.VisualStudio.dll
// Microsoft.VisualStudio.VSCorePackage
protected override void OnLoadOptions(string name, Stream stream)
{
	if (name.Equals(typeof(VsToolboxService).Name))
	{
		VsToolboxService vsToolboxService = this.GetService(typeof(IToolboxService)) as VsToolboxService; 
		if (vsToolboxService != null)
		{
			vsToolboxService.LoadOptions(stream); // [1]
		}
	}
}

at [1] , VSCorePackage will pass the stream to OptionService and calll vsToolboxService.OnLoadOptions(stream)

// Microsoft.VisualStudio.Toolbox.VsToolboxService
internal void LoadOptions(Stream stream)
{
	BinaryReader binaryReader = new BinaryReader(stream);
	BinaryFormatter binaryFormatter = new BinaryFormatter();
	int num = binaryReader.ReadInt32();
	for (int i = 0; i < num; i++)
	{
		string text = binaryReader.ReadString();
		int num2 = binaryReader.ReadInt32();
		for (int j = 0; j < num2; j++)
		{
			string text2 = this.Links.Read(stream);
			VsToolboxService.ToolboxItemContainer toolboxItemContainer = (VsToolboxService.ToolboxItemContainer)binaryFormatter.Deserialize(stream); // [2]
			if (text2 != null && File.Exists(text2))
			{
				toolboxItemContainer.LinkFile = text2;
				this.Links.TrackLink(text2);
				this.Items.GetFilteredList(text).Add(toolboxItemContainer);
			}
		}
	}
}

And [2] will call BinaryFormatter.Deserialize to get an object from the stream. This is a familiar use of BinaryFormatter deserialization. Due to insufficient type restrictions, we can directly use ysoserial.net to generate a payload and attempt to write it to the .suo file. When opening the project in Visual Studio, the malicious .suo file will be automatically loaded and trigger the execution of calc.exe.

BTW, there is another class with almost the same vulnerability, and interested readers should be able to find it quickly.

"Bypass" Trust Zones and MOTW?

The situation with Visual Studio is somewhat different. After conducting a search, we found an article here that provides insights.

For Visual Studio 2022 Preview 3, you’ll have to manually enable the “trusted locations” feature. Once enabled, Visual Studio will detect if you are attempting to open untrusted content and will show a new dialog that warns you about the security implications:

This setting needs to be manually enabled. However, even two years after the article was published, this setting remains disabled by default. There might be something preventing Visual Studio from enabling it.

But we still need to bypass the protection of MOTW, don't we?

In our tests, it seems that Visual Studio does not adhere to MOTW. sln files containing MOTW tags downloaded over HTTP can be opened without any warning. It may require specific methods or configurations to trigger the MOTW warning.

All in all, we can bypass the double protection of Trust Zones and MOTW without any effort, which poses a significant risk for unaware users.

Exploitation

A evil project structure would look like this:

$ tree -a
.
├── App1
│   └── Form1.cs
├── App1.sln
└── .vs
    └── App1
        └── v17
            └── .suo

In theory, the project could be even smaller, but for now, this should be sufficient. Compared to plaintext .sln or .csproj files, .suo is hidden (folders and files starting with . are not displayed by default in the file explorer) and its content is harder to read. There is also limited documentation describing the structure of this file, making it easier to overlook even with careful inspection.

Furthermore, due to Visual Studio's behavior of saving new content into the .suo file upon closing, the payload content is cleared, providing a natural concealment to this exploit technique. Additionally, this characteristic ensures that the exploit won't be triggered multiple times.

Lazarus has shown us how to poison projects:

Make the project publicly available on GitHub, for example, Active North Korean campaign targeting security researchers (Just hide the backdoor in code)
Send the project through a social platform, for example, New campaign targeting security researchers (Use PreBuildEvent technique)

Then, guide the victim to open the project. Unlike in 2021, code will be executed when the project is opened, without any additional clicks or missing MOTW / untrusted warning dialog.

With the power of deserialization, an attacker can execute arbitrary code in memory.

Proof of Concept

Clone or download this project

git clone https://github.com/cjm00n/EvilSln

Double-click the App1.sln file to open it with Visual Studio. (*.csproj works too)
The calculator will pop up.

Tested version: 17.7.5 (VS2022 update at 2023.10).

No Smartscreen warning, No trust need, No futher interaction need. But it will not be fixed, because Microsoft consider it's not a vulnerability.

Mitigation

Follow the steps outlined in Microsoft's article to manually open relevant settings: Improving developer security with Visual Studio 2022
Avoid opening any unknown projects in Visual Studio. As Microsoft states, "Opening a Visual Studio project is an insecure operation."

Discussion

After discovering this exploit, we promptly reached out to Microsoft for clarification and received a clear response stating that it is not a security issue.

After investigation, our team decided the issue is not a vulnerability. Opening a Visual Studio project is an insecure operation, as documented here: https://devblogs.microsoft.com/visualstudio/improving-developer-security-with-visual-studio-2022/

This aligns with the response provided in outflank's blog. Therefore, this is an exploit that will not be fixed, or rather, a series of exploits that will not be fixed. However, it is evident that there is a vulnerability here. We believe that there are more undisclosed files that automatically load when you open a project. Simply opening such a project is enough to compromise your machine.

Are there any known evil projects in the wild?

We quickly do an investigation using sourcegraph and found that there are at least 10,570 repositories on GitHub that contain .suo files. Unfortunately, we didn't have the time to inspect whether any of them contain malicious content.

Regardless, please be careful when using your IDE, especially Visual Studio. it does many things that you are unaware of under its roaring hood.

Credit

cjm00nw & edwardzpeng

danhpaiva/EncryptAesNet-console-app-csharp

2023-10-16T01:25:27Z

🛡️ ~ Academic example of AES encryption

🛡️ EncryptAesApp 😄

Status • Objective • Installation • Technology • Author • License

⌛ Concluded ⌛

📜 About

Project to explain cryptography to university students.
Application to encrypt data using the AES encryption model.
Made in .Net 6.

✔️ Installation

Clone the repo.
Have the .Net SDK installed on the machine.
Open Visual Studio Code or Visual Studio 2022.
Debug the code.

🧰 Technology

The following tools were used in the construction of the project:

IDE: Visual Studio Code
SDK: .Net 6

😎 Author

Developed by Daniel Paiva

🆓 Licence

View the license for this project MIT

mbucchia/VirtualDesktop-OpenXR

2023-10-17T01:26:13Z

An implementation of the OpenXR standard for Virtual Desktop

This program is an implementation of the OpenXR standard for Virtual Desktop on Windows. It allows you to run OpenXR applications without SteamVR.

DISCLAIMER: This runtime is not officially conformant per Khronos standards: it cannot be called "conformant" nor use the OpenXR trademark and logo. However, the runtime passes the majority of OpenXR conformance tests and the reason for not seeking official conformance is the required $30,000 adopter fee.

DISCLAIMER: This software is distributed as-is, without any warranties or conditions of any kind. Use at your own risks.

Details and instructions on the Wiki: https://github.com/mbucchia/VirtualDesktop-OpenXR/wiki

Donate

Donations are welcome and totally optional. Please use my GitHub sponsorship page to make one-time or recurring donations!

Thank you!

kokkos/kokkos

2023-10-17T01:26:13Z

Kokkos C++ Performance Portability Programming EcoSystem: The Programming Model - Parallel Execution and Memory Abstraction

Kokkos: Core Libraries

Kokkos Core implements a programming model in C++ for writing performance portable applications targeting all major HPC platforms. For that purpose it provides abstractions for both parallel execution of code and data management. Kokkos is designed to target complex node architectures with N-level memory hierarchies and multiple types of execution resources. It currently can use CUDA, HIP, SYCL, HPX, OpenMP and C++ threads as backend programming models with several other backends in development.

Kokkos Core is part of the Kokkos C++ Performance Portability Programming EcoSystem.

For the complete documentation, click below:

kokkos.github.io/kokkos-core-wiki

Learning about Kokkos

To start learning about Kokkos:

Kokkos Lectures: they contain a mix of lecture videos and hands-on exercises covering all the important Kokkos Ecosystem capabilities.
Programming guide: contains in "narrative" form a technical description of the programming model, machine model, and the main building blocks like the Views and parallel dispatch.
API reference: organized by category, i.e., core, algorithms and containers or, if you prefer, in alphabetical order.
Use cases and Examples: a series of examples ranging from how to use Kokkos with MPI to Fortran interoperability.

For questions find us on Slack: https://kokkosteam.slack.com or open a github issue.

For non-public questions send an email to: crtrott(at)sandia.gov

Contributing to Kokkos

Please see this page for details on how to contribute.

Requirements, Building and Installing

All requirements including minimum and primary tested compiler versions can be found here.

Building and installation instructions are described here.

Citing Kokkos

Please see the following page.

License

Under the terms of Contract DE-NA0003525 with NTESS, the U.S. Government retains certain rights in this software.

The full license statement used in all headers is available here or here.

random957654/Hactober-2023-1

2023-10-17T01:26:13Z

hacktoberfest, hacktoberfest-accepted, hacktoberfest2023

Hactober Fest 2023

Add your C++ (CPP) / C codes here.

We will accept Merge Request, Don't Worry if it Takes Long. You can create 4 or more pull request here ( every time you have to give a new C/C++ (CPP) programme )

HarshwardhanPatil07/HactoberFest2023

2023-10-16T01:25:36Z

A Simple😉 beginner friendly😊 Repo for all programmers and coders. All contributors are requested to star🌟this repo and and folllllow me. Contribute to start your journey with hacktoberfest. Happy Hacking💻!!!

HactoberFest2023

A Simple😉 beginner friendly😊 Repo for all programmers and coders. All contributors are requested to star🌟this repo and and follow me. Contribute to start your journey with hacktoberfest. Happy Hacking💻!!!

🌟Languages

💻 C
💻 C++
💻 PHP
💻 Python
💻 Java
💻 Javascript
💻 CSS
💻 HTML
💻 Nodejs

🛡Rules to Contribute

⚓Star this repo to get latest updates.
⚓Give your file a proper extension according to language. Ex. .py, .java, .js. html etc.
⚓Name your file related to your topic.
⚓Put your files in correct folder like .py in Python, .js in Javascript etc.
⚓Make sure you have entered your github - username, aim and date in your file as a comment.
⚓Make sure you have entered your name in CONTRIBUTORS.md file as mentioned (It's your responsibility) (optional).
⚓You can follow ME😁.

⚡If you are creating any PR then Add your name in CONTRIBUTORS.md file

🛡Follow rules strictly for successful merged PR!!!

❄Programs

⚡Create any pattern
⚡Make any algorithm (exclude calculator or related to it)
⚡Print 1 to 100 without using numbers
⚡Make calculator without using operators in program
⚡Calculate fibonacci series with classes
⚡Calculate factorial with classes
⚡Print IP Address and Hostname

Don't forget to read the contributing rules above to be successfully merged your PR and get rewards!!!

🏹 Visit Hacktoberfest to get more information about Hacktoberfest 2023!!!

🛡 Strictly follow rules to contribute for successful merged PR!!!

Note

All contributors who have followed the rules to contribute get successfully merged PR. Don't forget to follow!!!

Have some patience to get successfully merged PR. Keep Patience!!!

HAPPY HACKING🤞❤💻!!!

vortext/esther

2023-10-16T01:26:09Z

Dear Esther, you're about to become an idea for a diary app that embeds an LLM.

marianoguerra/pipe.clj

2023-10-16T01:26:09Z

library to build abstraction by composing small functions

cyverse-archive/morbixon

2023-10-16T01:26:09Z

Logging service and provenance facade for the iPlant Discovery Environment.

kenglxn/gitr

2023-10-16T01:26:14Z

perform git commands recursively

gbrolo/compilers-yapl-examples

2023-10-16T01:26:20Z

Set of YAPL program examples for compilers construction course

AsmrProg-YT/Personal-Portfolios

2023-10-16T01:26:34Z

All open source enthusiastic are Welcome !!

Welcome to the Frontend project Repository- Hacktoberfest2023

This is an open-source repository that gathers a variety of projects across different programming languages. Whether you're passionate about JavaScript or any other language, here you can delve into a diverse range of projects. This collection showcases the ingenuity and skills of developers, providing inspiration and practical examples for programming enthusiasts of all proficiency levels.

INSTRUCTION-

Star this repository.
Fork this Repository using the button at the top in the right corner.
Clone your forked repository to your PC ( git clone "URL" from clone option.)
Create a new branch for your modifications (ie. git branch new-user and check it out git checkout new-user or simply do git checkout -b new-user)
Add your files (git add -A), commit (git commit -m "added myself"), and push (git push origin new-user)
Create a pull request.

Steps to Successfully Raise and Merge Your PR.

👉 Fork this repository.

👉 Clone the repository to your local system.

👉 Create a branch with a name like projectname-username, e.g., git checkout -b ChatApp-thinkswell.

👉 Add your projects in the appropriate directory (or create one if it doesn't exist). The directory's name should be ProjectName/USERNAME, e.g., ChatApp/thinkswell.

👉 Add one project at a time.

👉 Add and commit your changes using git add -A, followed by git commit -m "Your commit message regarding the project."

👉 Push your changes to GitHub, for example, git push origin ChatApp-thinkswell.

👉 Click on 'Create a Pull Request.'

👉 Include some SCREENSHOTS/GIFs or a link to your working project in the description. ❗Important❗.

👉 Submit the PR.

👉 Give a ⭐ to the repository and FOLLOW me if you appreciate the project.

What You Can Contribute

We welcome contributions from the community to enrich and broaden our collection of mini-projects in various programming languages. Here are multiple ways you can contribute:

👉 Add New Projects

Do you have a creative project in any programming language that you believe would be an excellent addition to our collection? Submit your project!

👉 Bug Fixes

If you discover any issues or bugs in existing projects, please report them by creating an issue. Even better, submit a pull request with a fix!

👉 Create Issues

Have an idea for a new project? Create a new issue by clicking the 'New Issue' button and updating the provided template.

We're delighted to incorporate impressive portfolios into this repository!

Usage

This repository comprises a compilation of mini-projects in various programming languages, each designed to showcase a specific concept or feature. Here's how you can make use of these projects:

👉 Select a Project

Peruse the repository to find a project that piques your interest. Each project resides in its dedicated folder.

👉 Clone the Repository

Clone this repository to your local machine.

👉 Navigate to the Project Folder

Change the directory to the specific project you wish to explore.

👉 Open index.html or index.js in Your Browser

Most projects include an index.html or index.js file. Open this file in your web browser to interact with the project.

👉 Explore and Interact

Enjoy experimenting with the project!

Congratulations! You are now a part of the open-source community 🚀🚀🚀"

baekusboo/music-website

2023-10-16T01:26:34Z

A webpage with full of music suggestions!

Music World

A webpage with full of music suggestions from all over the world!

Welcome to Hacktoberfest #10 2023

⭐ This repository is made for beginners who are looking for a beginner-friendly repository to start open source contributions!

⭐ Feel free to use this project to make your first contribution to an open-source project on GitHub.

⭐ Star this repository for a better reach!

What is Hacktoberfest? 🤔

A month-long celebration from October 1st to October 31st presented by Digital Ocean and DEV Community collaborated with GitHub to get people involved in Open Source.

https://hacktoberfest.com/

Note 🔥

To qualify for digital rewards by Hacktoberfest, you must register for the event and make four Pull Requests (PRs) between October 1-31, 2023 (in any time zone).
Pull requests can be made in any GitHub or GitLab hosted project that’s participating in Hacktoberfest (look for the “hacktoberfest” topic).
The first 50,000 participants to have their first PR/MR accepted will have a tree planted in their name through Tree Nation

Contribution Rules 🤍

⭐ Follow these steps to add your song to the webpage:

Navigate to the JSON File:
- Open the musicData.json in your project directory.
Use the Template:
- Copy the provided JSON template structure to use it for your song addition.
```
{
    "id": ,
    "src": "PASTE_YOUR_SPOTIFY_LINK_HERE",
    "suggestedBy": "your-name"
}
```
Get the Link from Spotify:
- Choose your favorite song in Spotify.
- Navigate to the share options of the song.
- Select 'Copy Song Link' from the available options.
Paste Your Song's Link:
- Return to the musicData.json.
- Replace PASTE_YOUR_SPOTIFY_LINK_HERE in the JSON template with the copied song link.
Add Your Name:
- In the placeholder your-name within the "suggestedBy" field, replace your-name with your actual name.
Final Steps:
- Once you have made all the necessary changes, save the musicData.json file.
- Proceed to create a pull request for the changes you made. If you're collaborating on a platform like GitHub, ensure to provide a meaningful commit message and pull request description for others to understand your additions.

Your song will be added to the list once the pull request is reviewed and merged! 🎵

⭐ Don't make any other changes in the code! If you find any bug or have a feature suggestion, feel free to raise an issue.

Happy Coding!

Kritika30032002/To-Do-List-Application

2023-10-17T01:27:20Z

This is a To Do List Application

Join the discord server for more discussion:

To-Do List Application

This is a simple yet effective To-Do List Application built with HTML, CSS, and JavaScript. It allows you to manage your tasks and stay organized. You can add, edit, mark as completed, and delete tasks effortlessly.

Tech Stack

HTML
CSS
JavaScript

Installation

Clone the repository to your local machine:

git clone https://github.com/Kritika30032002/To-Do-List-Application.git

Open the index.html file in your web browser to start using the application.

Usage

Add tasks with a simple click.
Edit task names by double-clicking on them.
Mark tasks as completed by clicking on the checkbox.
Delete tasks by clicking on the trash icon.

Contributing

Feel free to contribute to this project by creating a pull request. We welcome any improvements, bug fixes, or new features.

Why & How to contribute?

If you find any bugs then please report them by creating an issue.
If you can make a website look good by modifying then go ahead and describe it in issue and create pull request.
If you can add more functionality, then create an issue and contribute by making pull request.

Thanks to all Contributors 💪

Thanks a lot for spending your time.
Keep rocking 🍻
Also Give it a Star 🌟, If you loved contributing to the project.

MIT Licensed

canonical/ubuntu-desktop-provision

2023-10-16T01:26:52Z

Ubuntu Desktop Provision

classDiagram
    ubuntu_bootstrap <|-- ubuntu_desktop_installer
    ubuntu_bootstrap <|-- ubuntu_flavor_installer
    ubuntu_init <|-- ubuntu_core_desktop_init
    ubuntu_init <|-- ubuntu_welcome
    ubuntu_provision <|-- ubuntu_bootstrap
    ubuntu_provision <|-- ubuntu_init
    ubuntu_provision: - shared pages
    ubuntu_provision: - service interfaces
    ubuntu_bootstrap: - subiquity-based services
    ubuntu_bootstrap: - configurable subset of pages
    ubuntu_init: - xdg/dbus/gsettings-based services
    ubuntu_init: - configurable subset of pages
    ubuntu_desktop_installer: - (main.dart)
    ubuntu_desktop_installer: - provision.conf
    ubuntu_desktop_installer: - snapcraft.yaml
    ubuntu_flavor_installer: - (main.dart)
    ubuntu_flavor_installer: - provision.conf
    ubuntu_flavor_installer: - snapcraft.yaml
    ubuntu_core_desktop_init: - (main.dart)
    ubuntu_core_desktop_init: - provision.conf
    ubuntu_core_desktop_init: - snapcraft.yaml
    ubuntu_welcome: - (main.dart)
    ubuntu_welcome: - provision.conf
    ubuntu_welcome: - snapcraft.yaml

Used by

Configuration

Supported formats:

TOML (.conf)

[bootstrap]
pages = "locale,keyboard,source,storage"

[init]
pages = "timezone,identity"

YAML (.yaml, .yml)

bootstrap:
  pages:
    - locale
    - keyboard
    - source
    - storage

init:
  pages:
    - timezone
    - identity

Lookup order:

/etc/ubuntu-provision.{conf,yaml,yml} (admin)
/usr/local/share/ubuntu-provision.{conf,yaml,yml} (oem)
/usr/share/ubuntu-provision.{conf,yaml,yml} (distro)
<app>/data/flutter_assets/ubuntu-provision.{conf,yaml,yml} (app)

Translations

This project is being translated using Weblate, a web tool designed to ease translating for both developers and translators.

Contributing

See our contributor guidelines.

License

The Ubuntu Desktop Provision is licensed under the GNU General Public License version 3.

abuanwar072/Flutter-Parallax-Effect

2023-10-16T01:26:52Z

A Flutter app that demonstrates Flutter's ability to create a beautiful UI with complex animations.

Description

A demo app that demonstrates Flutter's ability to create beautiful UI with complex animations. The app fetches recipes from local storage.

📦 Packages

Description	Package
Architecture	Reference Architecture
State Management	flutter_riverpod
Theming	flex_color_scheme
animation	flutter_animate & explicit animation

Screenshot 📸

https://github.com/Dev-Salem/dribbble_recipe_challenge/assets/108498811/b276696e-aafe-40e4-8134-b53991e654d6

🩻 Project Structure

|- assets <- recipe.json and images
|
lib
|
|_ 📁src
	|
	|__ 📁core
	|	|__ 📁animation <- page transition
	|	|__ 📁constants
	|	|__ 📁theme <- define themes & and colors
	|	|__ 📁widgets <- widgets that are used in multiple screens
	|
    	|__ 📁onboarding <- onboarding screen and its widgets
	|
	|__ 📁recipes 
        	|__ 📁domain <- entities
		|__ 📁data <- recipe repository (fetch recipes from recipe.json)
        	|__ 📁presentation <- Home Screen & Recipe Details Screen and other related widgets

💭 Inspiration

Dribbble

🗞️ License

MIT License

raushan8586/devops-edureka-september-2023

2023-10-16T01:27:08Z

Aws Student Clubs Ewha 2nd Handson - Docker + CI/CD Prac

spectrocloud/CanvOS

2023-10-17T01:28:39Z

A utility for creating Edge artifacts for deploying Palette Edge clusters.

nmbrone/feature_supervisor

2023-10-17T01:28:55Z

Elixir Supervisor

y047aka/elm-emaki

2023-10-16T01:27:46Z

svaante/dape

2023-10-16T01:27:54Z

Debug Adapter Protocol for Emacs

#+title: Dape - Debug Adapter Protocol for Emacs #+author: Daniel Pettersson #+property: header-args :results silent #+language: en

Dape is an debug adapter client for Emacs.

Use ~~dape-configs~~ to set up your debug adapter configurations. To initiate debugging sessions, use the command ~~dape~~.

For complete functionality, activate ~~eldoc-mode~~ in your source buffers and enable ~~repeat-mode~~ for ergonomics.

Features

Log breakpoints
Conditional breakpoints
Variable explorer
Variable watch
Variable hover with ~~eldoc~~
REPL
Memory viewer with ~~hexl~~
~~compile~~ integration
Debug adapter configuration ergonomics
No dependencies

[[https://raw.githubusercontent.com/svaante/dape/resources/screenshot.png]] Screenshot taken with [[https://github.com/protesilaos/ef-themes][ef-trio-dark]].

Configuration Currently =Dape= does not come with any debug adapter configuration.

#+begin_src emacs-lisp (use-package dape ;; Currently only on github :straight (dape :type git :host github :repo "svaante/dape") :config ;; Use n for next etc. in REPL ;; (setq dape-repl-use-shorthand t)

;; By default dape uses gdb keybinding prefix
;; (setq dape-key-prefix "\C-x\C-a")

;; Kill compile buffer on build success
;; (add-hook 'dape-compile-compile-hooks 'kill-buffer)

;; Projectile users
;; (setq dape-cwd-fn 'projectile-project-root)
)

#+end_src

Differences with dap-mode [[https://github.com/emacs-lsp/dap-mode][dap-mode]] is the most popular alternative and is of course much more mature and probably more feature rich (have not used ~~dap-mode~~ extensively).

Dape has no dependencies outside of packages included in emacs, and tries to use get as much out of them possible.

Dape takes a slightly different approach to configuration.

Dape does not support ~~launch.json~~ files, if per project configuration is needed use ~~dir-locals~~.
Tries to simplify configuration, by having just a plist.
Dape tries to improve config ergonomics in ~~dape~~ completing-read by using options to change/add plist entries in an already existing config, example: ~~adapter-config :program ＂/home/user/b.out＂ compile ＂gcc -g -o b.out main.c＂~~.
No magic, no special variables. Instead, functions and variables are resolved before starting a new session.
No batteries included. Many, suffer from a significant drawback: they're tightly coupled with the vscode extension they're bundled with. This tight coupling results in launch/attach requests being specific to each adapter, devoid of reasonable defaults as they are stored within the extension itself, leading to an ever-changing and unstable API. Consequently, attempting to include default configurations for each adapter seems like a losing proposition.
Tries to be envision to how debug adapter configuration would be implemented in emacs if vscode never existed.

Supported debug adapters In theory all debug adapters should be compatible with =Dape=.

** Javascript - vscode-js-debug To install ~~vscode-js-debug~~ pull down the [[https://github.com/microsoft/vscode-js-debug][repo]]. #+begin_src sh npm install npx gulp dapDebugServer #+end_src

Example launch configuration for ~~node~~. #+begin_src emacs-lisp (add-to-list 'dape-configs `(vscode-js-node modes (js-mode js-ts-mode) host "localhost" port 8123 command "node" command-cwd "path/to/vscode-js-debug/dist/" command-args ("src/dapDebugServer.js" "8123") :type "pwa-node" :request "launch" :cwd dape-cwd-fn :program dape-find-file-buffer-default :outputCapture "console" :sourceMapRenames t :pauseForSourceMap nil :enableContentValidation t :autoAttachChildProcesses t :console "internalConsole" :killBehavior "forceful")) #+end_src

For more information see [[https://github.com/microsoft/vscode-js-debug/blob/main/OPTIONS.md][OPTIONS.md]].

** Go - delve See [[https://github.com/go-delve/delve/tree/master/Documentation/installation][delve installation]].

#+begin_src emacs-lisp (add-to-list 'dape-configs `(delve modes (go-mode go-ts-mode) command "dlv" command-args ("dap" "--listen" "127.0.0.1:55878") command-cwd dape-cwd-fn host "127.0.0.1" port 55878 :type "debug" :request "launch" :cwd dape-cwd-fn :program dape-cwd-fn)) #+end_src

For more information see [[https://github.com/go-delve/delve/blob/master/Documentation/usage/dlv_dap.md][documentation]].

** C, C++ and Rust Download latest [[https://github.com/vadimcn/codelldb/releases][release]] and unpack ~~vsix~~ file with your favorite unzipper.

#+begin_src emacs-lisp (add-to-list 'dape-configs '(codelldb modes (c-mode c-ts-mode c++-mode c++-ts-mode rust-ts-mode rust-mode) ;; Replace vadimcn.vscode-lldb with the vsix directory you just extracted command "path/to/vadimcn.vscode-lldb/adapter/codelldb" host "localhost" port 5818 command-args ("--port" "5818") :type "lldb" :request "launch" :cwd dape-cwd-fn :program dape-find-file)) #+end_src

See [[https://github.com/vadimcn/codelldb/blob/v1.10.0/MANUAL.md][manual]] for more information.

** C and C++ - cppdbg Download latest [[https://github.com/microsoft/vscode-cpptools/releases][release]] and unpack ~~vsix~~ file with your favorite unzipper. Then ~~chmod +x debugAdapters/bin/OpenDebugAD7~~.

#+begin_src emacs-lisp ;; Replace ms-vscode.cpptools with the vsix directory you just extracted (setq dape-cppdbg-command "path/to/ms-vscode.cpptools/debugAdapters/bin/OpenDebugAD7") (add-to-list 'dape-configs `(cppdbg modes (c-mode c-ts-mode c++-mode c++-ts-mode) command-cwd ,(file-name-directory dape--cppdbg-command) command cppdbg-command :type "cppdbg" :request "launch" :cwd dape-cwd-fn :program dape-find-file :MIMode ,(cond ((executable-find "gdb") "gdb") ((executable-find "lldb") "lldb")))) #+end_src

See [[https://code.visualstudio.com/docs/cpp/launch-json-reference][options]].

** Python - debugpy Install debugpy with pip ~~pip install debugpy~~

#+begin_src emacs-lisp (add-to-list 'dape-configs `(debugpy modes (python-ts-mode python-mode) command "python3" command-args ("-m" "debugpy.adapter") :type "executable" :request "launch" :cwd dape-cwd-fn :program dape-find-file-buffer-default)) #+end_src

See [[https://github.com/microsoft/debugpy/wiki/Debug-configuration-settings][options]].

** Other untested adapters If you find a working configuration for any other debug adapter please submit a PR.

See [[https://microsoft.github.io/debug-adapter-protocol/implementors/adapters/][microsofts list]] for other adapters, your mileage will vary.

Roadmap

More options for indicator placement
Improving completion in REPL
Usage of "setVariable" inside of ~~dape-info~~ buffer
Improve memory reader with auto reload and write functionality
Individual thread controls
Variable values displayed in source buffer, this seams to require integration with lsp-mode and eglot

Bugs and issues Before reporting any issues take a look at ~~dape-debug~~ buffer with all debug messages enabled. ~~(setq dape--debug-on '(io info error std-server)~~.

ronnieholm/FSharp-clean-architecture-sample

2023-10-16T01:28:06Z

Applying F# principles to domain driven design/clean architecture.

Scrum clean architecture sample

Got a comment or a question? Don't hesitate to drop me an email or open an issue.

This sample focuses on applying functional constructs over cluing together libraries and frameworks. It substitutes the .NET dependency injection container, FluentValidation, MediatR, Entity Framework, Moq, Respawn, and a migration tool for simpler constructs.

It's an example of imperative shell, functional core. Specifically, Program.fs and Infrastructure.fs make up the shell while Application.fs and Domain.fs make up the core.

Where F# shines is in the core and IntegrationTest.fs. The shell is similar in nature to many C# applications.

The application has the following features:

REST API adhering to the Zalando API guidelines with JWTs supporting role-based security.
A simple identity provider to issue, renew, and inspect JWTs accepted by the REST API.
Command Query Responsibility Segregation (CQRS) access to the application layer from clients.
Paged responses for endpoints which return collections.
Integration tests with the ability to fake any dependency.
Database migrations and initial data seeding.
ASP.NET health checks for memory and database.
Architecture decision records under docs/architecture-decision-records.

The Scrum domain was chosen because it offers sufficient complexity and everyone is familiar with it, though most aspects of the application is illustrated with stories and tasks only.

With only stories and tasks, clean architecture may seem to introduce a disproportional amount of complexity. A larger domain and integrations with external services is where clean architecture starts to pays off.

That said, not every project requires an implementation of every concept from clean architecture and domain driven design. Those should be scaled up or down based on actual business complexity.

Getting started

Running the tests or the web app creates the SQLite databases in the Git root as scrum_web.sqlite and scrum_test.sqlite.

$ dotnet tool restore
$ dotnet build
$ dotnet test
$ dotnet run --project src/Scrum

Opening the Git repository with VSCode will make it pick up the DevContainer configuration.

Operations

# Authentication (supported roles: member and/or admin)
## Post
curl "https://localhost:5000/authentication/issue-token?userId=1&roles=member,admin" --insecure --request post
curl https://localhost:5000/authentication/renew-token --insecure --request post -H "Authorization: Bearer <token>"
curl https://localhost:5000/authentication/introspect --insecure --request post -H "Authorization: Bearer <token>"

# Stories
## Post
curl https://localhost:5000/stories --insecure --request post -H 'Content-Type: application/json' -H 'Authorization: Bearer <token>' -d '{"title": "title", "description": "description"}'
curl https://localhost:5000/stories/<storyId>/tasks --insecure --request post -H 'Content-Type: application/json' -H 'Authorization: Bearer <token>' -d '{"title": "title","description": "description"}'

## Put
curl https://localhost:5000/stories/<storyId> --insecure --request put -H 'Content-Type: application/json' -H 'Authorization: Bearer <token>' -d '{"title": "title1","description": "description1"}'
curl https://localhost:5000/stories/<storyId>/tasks/<taskId> --insecure --request put -H 'Content-Type: application/json' -H 'Authorization: Bearer <token>' -d '{"title": "title1","description": "description1"}'

## Delete
curl https://localhost:5000/stories/<storyId>/tasks/<taskId> --insecure --request delete -H 'Authorization: Bearer <token>'
curl https://localhost:5000/stories/<storyId> --insecure --request delete -H 'Authorization: Bearer <token>'

## Get
curl https://localhost:5000/stories/<storyId> --insecure -H 'Authorization: Bearer <token>'
curl "https://localhost:5000/stories?limit=<limit>&cursor=<cursor>" --insecure -H 'Authorization: Bearer <token>'

# PersistedDomainEvents
## Get
curl https://localhost:5000/persisted-domain-events/<aggregateId> --insecure -H 'Authorization: Bearer <token>'

# Health
## Get
curl https://localhost:5000/health --insecure

Dymerz/StarCitizen-Localization

2023-10-16T01:28:16Z

Language File Installation Guide

DPM2/GWJ62

2023-10-16T01:28:32Z

Godot Wild Jam #62 1st place winner game

ckosmic/minecraft-psx

2023-10-17T01:30:14Z

PlayStation 1 shaders for Minecraft

u1dm/dotfiles

2023-10-17T01:30:14Z

Hyprland monet dotfiles

aws/aws-lambda-go

2023-10-16T01:28:53Z

Libraries, samples and tools to help Go developers develop AWS Lambda functions.

AWS Lambda for Go

Libraries, samples, and tools to help Go developers develop AWS Lambda functions.

To learn more about writing AWS Lambda functions in Go, go to the official documentation

Getting Started

// main.go
package main

import (
	"github.com/aws/aws-lambda-go/lambda"
)

func hello() (string, error) {
	return "Hello λ!", nil
}

func main() {
	// Make the handler available for Remote Procedure Call by AWS Lambda
	lambda.Start(hello)
}

Building your function

Preparing a binary to deploy to AWS Lambda requires that it is compiled for Linux and placed into a .zip file.

For developers on Linux and macOS

# Remember to build your handler executable for Linux!
# When using the `provided.al2` runtime, the handler executable should be named `bootstrap`
GOOS=linux GOARCH=amd64 go build -o bootstrap main.go
zip lambda-handler.zip bootstrap

For developers on Windows

Windows developers may have trouble producing a zip file that marks the binary as executable on Linux. To create a .zip that will work on AWS Lambda, the build-lambda-zip tool may be helpful.

Get the tool

go.exe install github.com/aws/aws-lambda-go/cmd/build-lambda-zip@latest

Use the tool from your GOPATH. If you have a default installation of Go, the tool will be in %USERPROFILE%\Go\bin.

in cmd.exe:

set GOOS=linux
set GOARCH=amd64
set CGO_ENABLED=0
go build -o bootstrap main.go
%USERPROFILE%\Go\bin\build-lambda-zip.exe -o lambda-handler.zip bootstrap

in Powershell:

$env:GOOS = "linux"
$env:GOARCH = "amd64"
$env:CGO_ENABLED = "0"
go build -o bootstrap main.go
~\Go\Bin\build-lambda-zip.exe -o lambda-handler.zip bootstrap

Deploying your functions

To deploy your function, refer to the official documentation for deploying using the AWS CLI, AWS Cloudformation, and AWS SAM.

Event Integrations

The event models can be used to model AWS event sources. The official documentation has detailed walkthroughs.

circled-me/server

2023-10-16T01:28:53Z

Photo backup and sharing server

circled.me community server

This project aims to help people easily backup and share photos, videos, albums on their own server. Focusing on performance, low footprint and ease of implementation and use. Upcoming releases will further enable you to share with your circles by including group chats and more.

After certain services that scan for faces, locations, etc, became paid some time ago, I have decided I'd rather be able to host my own photos. The main reason being, of course, privacy! But also at that time, there was no alternatve that offered good performance and low CPU/memory usage. This project has currently only one contributor (i.e. me), so help will be greatly appreciated 😊

Another focus of this project is having the ability to host everything a community needs to be able to communicate and exchange photos, ideas, etc. I strongly believe in local/focused communities and sharing with the community, but at the same time - keeping everything private, within the community. In my personal case, I share mostly photos with my family and close friends.

Logo is madebytow.com

Mobile app

The circled.me mobile app works with multiple accounts and servers. For example, you can have your family server and account, and your gaming/running/reading comunities' accounts on the same app and being able to interact with all of them at the same time.

⚠️ NOTE: Please note that this project is still in development and could introduce breaking changes.

⚠️ WARNING: Do not use this as your main/only backup solution.

Main features:

Fast response times and low CPU and memory usage
iOS and Android photo backup (using the circled.me app)
- Supports either locally mounted disks or
- S3-compatible Services - this allows different users to use their own S3 bucket on the same server
Push notifications for new Album photos, etc
Albums
- Adding local server contributors and viewers
- Sharing albums with anyone with a "secret" link
Filtering photos by year, month, location, etc
Moments - automatically grouping photos by time and location
Reverse geocoding for all assets
Automatic video conversion to web-compatible H.264 format

Feautres that are in-progress and/or prioritised:

Map browsing of photos
Group chats
Face detection and tagging
Bulk-adding assets by:
- Scanning directories on local disks
- Scanning objects on already existing S3 bucket prefix

Compiling and Running the server

The easiest way to try and run the server is within a docker container, see example docker-compose file below.

docker-compose -f docker-compose-example.yaml up

Note: If you change the source code (e.g. pull new version), you might need to remove your local cached Docker image for the circled-server service.

Now you can use the app and connect to your server at http://<YOUR_IP>:8080 and create your first admin user. Then you need to create a Storage Bucket from Settings and assign that to any User that is going to backup their photos there. If you used the example docker compose above, then the Path or your new Storage Bucket should be something like /mnt/data1/some-sub-dir

Current configuration environment variables:

MYSQL_DSN - see example or refer to https://github.com/go-sql-driver/mysql#dsn-data-source-name
BIND_ADDRESS - IP and port to bind to (incompatible with TLS_DOMAINS). This is useful if your server is, say, behind reverse proxy
TLS_DOMAINS - a list of comma-separated domain names. This uses the Let's Encrypt Gin implementation (https://github.com/gin-gonic/autotls)
DEBUG_MODE - currently defaults to yes

docker-compose example

This docker-compose file is just an example and does provide only basic configuration. Modify the mysql-data and asset-data below at the very least to suitable locations with enough space, etc. Better though, use your "proper" MySQL server instead of running it in Docker.

NOTE: Please do not use this in production.

version: '2'
services:
  circled-server:
    image: gubble/circled-server:latest
    # build:
    #  dockerfile: Dockerfile
    restart: always
    depends_on:
      mysql:
        condition: service_healthy
    ports:
      - "8080:8080"
    environment:
      MYSQL_DSN: "root:@tcp(mysql:3306)/circled?charset=utf8mb4&parseTime=True&loc=Local"
      BIND_ADDRESS: 0.0.0.0:8080
    volumes:
      - ./asset-data:/mnt/data1
  mysql:
    image: mysql:5.7
    command: --default-authentication-plugin=mysql_native_password
    restart: always
    volumes:
      - ./mysql-data:/var/lib/mysql
    environment:
      MYSQL_DATABASE: circled
      MYSQL_ALLOW_EMPTY_PASSWORD: "yes"
      MYSQL_ROOT_HOST: "%"
    healthcheck:
      test: mysqladmin ping --silent
      start_period: 5s
      interval: 3s
      timeout: 5s
      retries: 20

ghcjs/ghcjs

2023-10-17T01:30:51Z

Haskell to JavaScript compiler, based on GHC

Introduction

GHCJS is a Haskell to JavaScript compiler that uses the GHC API.

Quick Start - Developing GHCJS

GHCJS contains a library, ghcjs, which contains the JavaScript code generator and a slightly customized variant of the ghc library, and several executable programs.

The repository has several submodules and some files must be generated before the package can be installed.

prerequisites

GHC

You need the same major version of GHC as the version of the GHCJS branch you're building.

cabal-install

cabal-install 3.0 is supported

emscripten emsdk

GHCJS uses a C toolchain, mostly for build system related tasks like the C preprocessor, Autoconf scripts and tools like hsc2hs. Direct support for using compiled foreign libraries from Haskell code may follow at a later date.

Please follow the installation instructions at https://emscripten.org/docs/getting_started/index.html

GHCJS requires the "upstream" emscripten backend, which is the default now. The earlier "fastcomp" backend will not work.

getting and preparing the source tree

$ git clone https://github.com/ghcjs/ghcjs.git
$ cd ghcjs
$ git submodule update --init --recursive

building the compiler

GHCJS depends on a few "local" packages in the source tree. You can use cabal-install and stack to set up a build environment that contains these packages.

Cabal new-install

After the source tree has been prepared, the package can be installed. You may want ensure that binaries of earlier versions are overwritten:

cabal v2-install --overwrite-policy=always --install-method=copy --installdir=inplace/bin

At the time of writing, cabal-install does not support creating symbolic links on Windows, even though this is the default installation method. A workaround is telling it to copy the executables instead:

cabal v1-install --prefix=inplace

v1 style Cabal sandbox

v1 style cabal sandboxes are also supported

if you want to build with a Cabal sandbox, use the makeSandbox.sh script to add the local packages.

$ cabal v1-sandbox init
$ cabal v1-install

stack

or you can use stack:

$ stack --system-ghc --skip-ghc-check install --local-bin-dir=inplace/bin

Booting GHCJS

The ghcjs-boot program builds the "boot" libraries, like ghc-prim, base and template-haskell with GHCJS. After booting, GHCJS can compile regular Haskell programs and packages.

ghcjs-boot needs to be able to find the emscripten toolchain, a nodejs executable. The easiest way to do this is by running the emsdk_env.sh script. After that, you can run ghcjs-boot by pointing it to the boot libraries (the directory containing the boot.yaml file)

$ source ~/emsdk/emsdk_env.sh
$ ./inplace/bin/ghcjs-boot -s ./lib/boot

GHCJS executables and library paths

After booting, you can add the directory containing the GHCJS binaries to your executable PATH. The ghcjs-boot program prints the location after finishing building the libraries.

You can also create a symbolic link for the ghcjs and ghcjs-pkg programs, or use the --with-compiler and --with-hc-pkg flags when using cabal-install

Generating a source distribution

if you work on boot packages that need some for an upstream library, make sure to update the patches in /lib/patches first

$ ./utils/updatePatches.sh

then regenerate the packages

$ ./utils/makePackages.sh

aws-samples/karpenter-blueprints

2023-10-16T01:29:26Z

Karpenter Blueprints is a list of common workload scenarios following best practices. You'll find here details of why configuring the Karpenter and Kubernetes objects in such a way is important when using Karpenter on EKS.

sd031/three-tier-eks-iac

2023-10-16T01:29:26Z

riteshbehal/Assignments

2023-10-16T01:29:26Z

AWS Assignments

megayuchi/VH_SDK

2023-10-17T01:31:07Z

hackbysarthak03/Hacktoberfest2023

2023-10-16T01:29:35Z

A Webpage for your valuable contribution to Hacktoberfest 2023!

🚀 Hacktoberfest 2023

A Simple Webpage, to add your github profile. UI can also be fixed, all depends on you ! So, try out this repo 🤩 and win exciting rewards from Hacktoberfest 2023 ! ✨

Every PR will be Merged 🙂

We are excited to have you as a contributor 🤩🤩

Make a Simple Contribution :

Open the index.html file
You will see a block of code in the comment section
Just add that code with YOUR NAME and YOUR GITHUB PROFILE link to make a simple contribution

And that's all ! 🚀

How to Contribute

To make Contribution :

Fork this repository to your GitHub account.
Clone the forked repository to your local machine:

   git clone https://github.com/hackbysarthak03/Hacktoberfest2023.git

Create a new branch for your contribution:

git checkout -b feature/your-feature-name

Make your changes ( See below Section on What to Contribute? )

Commit your changes and push them to your forked repository:

git add .
git commit -m "Add your meaningful commit message here"
git push origin feature/your-feature-name

Create a Pull Request (PR) from your forked repository to this main repository.
Your PR will be reviewed and merged if everything is in order.

Contribution Guidelines

Ensure your code follows the project's coding standards and conventions.
Make sure to document your code and add comments where necessary.
Test your changes to ensure they work as expected.
Please be respectful and considerate of others in your interactions on this repository.

Happy Hacking!

Thank you for your interest in contributing to this project and for participating in Hacktoberfest. We appreciate your contributions and look forward to seeing your amazing work!

Happy coding!

CFiggers/janet-lsp

2023-10-17T01:31:52Z

A Language Server (LSP) for the Janet programming language.

yuliskov/SmartTube

2023-10-16T01:30:06Z

SmartTube - an advanced player for set-top boxes and tv running Android OS

SmartTube (old name SmartTubeNext)

SmartTube is an advanced player for Android TVs and TV boxes, free & open source. You can play content from different public sources.

✅ Features: no ads ‧ SponsorBlock ‧ adjustable playback speed ‧ 8k support ‧ 60fps ‧ HDR ‧ read live chat ‧ customizable buttons ‧ no Google Services ‧ helpful international community

❌ Disadvantages: no support for phones and tablets, no comments stability, voice search and casting support might be worse than in the official apps, depending on your device; give it a try!

Do you have any question? Ctrl+F or ⌘F this readme first!

Device support

✅ supported: all Android TVs and TV boxes (incl. FireTV & NVIDIA Shield), even older ones with Android 4.3 (Kitkat). ❌ not supported: Smartphones, non-Android plattforms like Samsung Tizen, LG webOS, iOS, etc. ">

Installation

video of the installation (note: download url changed to kutt.it/stn_beta or kutt.it/stn_stable)

Do not download SmartTube from any app store, APK websites or blogs; these were uploaded by other people and may contain malware or ads. SmartTube is not officially published on any app store. Sadly, the Google PlayStore does not allow ad-free Youtube apps using unofficial APIs.

There is a beta release (recommended) and a stable release. Beta gets new features and bugfixes faster than the stable release.

You can use either of the following methods to install the app:

(easiest) install Downloader by AFTVnews on your Android TV, open it and enter kutt.it/stn_beta or kutt.it/stn_stable, then read, understand and confirm the security prompts. (You can also enter 79015 (for beta) or 28544 (for stable), but this requires an extra step to install the AFTVnews Downloader browser addon if you haven't already.)
install a file transfer app on your Android TV, download the APK on your phone or computer and transfer it to your TV (e.g. Send Files to TV from the Google Play Store / Amazon AppStore)
download the APK onto a USB stick, put the USB stick into your TV and use a file manager app from the Google Play Store / Amazon AppStore (e.g. FX File Explorer or X-plore). Android's preinstalled file manager does not work! Do not get the ad-infested FileCommander.
if you are an advanced user, you can install it using ADB. guide | alternative guide

Troubleshooting: See device specific notes below. If installation fails, either your disk space is full or the APK file didn't download correctly; clear up space and try downloading again. If the app installed, but crashes when opening, make sure to install it to internal memory, not to an SD card / external storage.

The app has a built-in updater with changelog. You can also find all releases and the changelog on the Telegram channel @SmartTubeNewsEN (readable without account) or on Github.

latest beta download

latest stable download

Installation (Chromecast with Google TV)

On Chromecast with Google TV, installation of apps is blocked by default, so an extra step is required:

4.1. Enable Developer Options

On your Chromecast, open the side menu and go to Settings > System > About. Scroll down to the Android TV OS build section and click that repeatedly. A toast message will appear, explaining that you are a few steps away from being a developer. Continue clicking until you trigger it.

4.2. Turn on the "unknown sources" setting

Go back to the main Settings page and select Apps > Security & Restrictions > Unknown sources. Turn on the toggle for [Downloader by AFTVnews or] whichever file browser you decided to use [...].

[source & picture guide]

After this, you can follow the general installation guide above.

Installation (Xiaomi devices with Chinese firmware)

Xiaomi's Chinese firmware might block the installation of the beta version. The international firmware is not affected. Solutions:

use SmartTube's stable version instead (recommended)
use the international firmware for your device
(if your device is from 2020 or before) You can do a factory reset and then install SmartTube beta before doing any system updates. You can then safely update your system, SmartTube should continue working.

Updating

The app has a built-in updater. You only need to follow the installation procedure once. A few seconds after launching SmartTube, it will notify you if there is any update and also show a changelog. You can disable automatic update checks or manually update in the settings under "about".

If the installation fails, either your disk space is full or the update didn't download correctly; clear up space and try updating again (Settings > About > Check for updates).

Compatibility

SmartTube requires Android 4.3 or above. It does not work on non-Android devices (incl. LG or Samsung TVs). On unsupported TVs, you can use a TV stick or TV box. Though this app technically runs on smartphones and tablets, it is not optimized for such and offers no official support!

It has been successfully tested on TVs, TV boxes and TV sticks that are based on Android, including:

Android TVs & Google TVs (e.g. Philips, Sony)
Chromecast with Google TV & TVs with Chromecast built-in
Amazon FireTV stick (all generations)
NVIDIA Shield
TV boxes running Android (many cheap chinese no-name boxes)
Xiaomi Mi Box

Features

Adblocking

SmartTube does not show any ad banners, preroll ads or ad intermissions. It not just tries to prevent them, it is literally programmed to be completely unable to display any ads, so YouTube cannot slip anything in. This also means you cannot allow ads or whitelist channels. Some YouTube channels include sponsored messages in their videos, these can also be skipped, see SponsorBlock below.

SponsorBlock

SmartTube includes a SponsorBlock integration. From the SponsorBlock website:

SponsorBlock is an open-source crowdsourced browser extension and open API for skipping sponsor segments in YouTube videos. [...] the extension automatically skips sponsors it knows about using a privacy preserving query system. It also supports skipping other categories, such as intros, outros and reminders to subscribe [and non-music parts in music videos].

You can select which categories you want to skip in the settings. Unlike the browser addon, in SmartTube you cannot submit new segments (TVs and TV remotes aren't great devices for such precise operations). Note that SponsorBlock is a free and voluntary project based on user submissions, so don't expect it to 100% work every time. Sometimes, sponsor segments are not yet submitted to the database, sometimes the SponsorBlock servers are offline/overloaded.

Casting

To cast videos from your phone (or other devices), you must link that device to your TV. Unlike the original YouTube app, SmartTube does not automatically show up when you are in the same wifi network. How to link your smartphone and TV:

open SmartTube and go to settings
go to "Remote control" (2nd option)
open your YouTube app on your phone, go to settings > General > watch on TV
click on connect using TV-code and enter the code from your TV

Screenshot guide

Due to technical limitations, you need to open the app on the TV before casting; SmartTube cannot automatically wake up the TV.

Picture-in-Picture (PiP)

SmartTube supports playing videos in PiP mode. This needs to be enabled under Settings > General > Background playback > Picture in picture. The video will go into PiP mode when you press home while playing a video, and also when you press back if enabled in Settings > General > Background playback (activation).

Adjust Speed

You can adjust the playback speed pressing the speed-indicator icon (gauge) in the top row of the player. This is remembered across videos. Some speeds may case frame drops, this is a known issue.

Voice Search

To enable global voice search, an additional app must be installed alongside SmartTube. This bridge app can intercept the System's attempts to open the original YouTube app and open SmartTube instead. For this to work, you must uninstall the original YouTube app. We know this sucks, but you can always reinstall it if you change your mind. The bridge app will not show up in your launcher and you cannot launch it directly; it is only used internally by the system's voice search. On some devices, you need to explicitly say "Youtube" when searching (e.g. say "youtube cute cats" instead of just "cute cats").

On Amazon Fire TV:

uninstall the original YouTube app (no root required)
download and install the Amazon Bridge SmartTube app: https://kutt.it/stn_bridge_amazon (e.g. via Downloader by AFTVnews)

On Google Chromecast with Google TV:

uninstall the original YouTube app (no root required)
download and install the ATV Bridge SmartTube app: https://kutt.it/stn_bridge_atv (e.g. via Downloader by AFTVnews)

On all other Android devices, sadly root is required to enable this:

root your device (search for a guide for your specific device)
uninstall the official YouTube app using root (adb shell pm uninstall com.google.android.youtube.tv)
download and install the ATV Bridge SmartTube app: https://kutt.it/stn_bridge_atv (e.g. via Downloader by AFTVnews)

Donation

If you want to support my developments you are welcome to buy me a cup of coffee :)

Patreon (Visa, Mastercard, PayPal)
PayPal: firsth ash@gmai l.com

BTC: 1JAT5VVWarVBkpVbNDn8UA8HXNdrukuBSx
LTC: ltc1qgc24eq9jl9cq78qnd5jpqhemkajg9vudwyd8pw
ETH: 0xe455E21a085ae195a097cd4F456051A9916A5064
ETC: 0x209eCd33Fa61fA92167595eB3Aea92EE1905c815
XMR: 48QsMjqfkeW54vkgKyRnjodtYxdmLk6HXfTWPSZoaFPEDpoHDwFUciGCe1QC9VAeGrgGw4PKNAksX9RW7myFqYJQDN5cHGT
USDT (ERC20): 0xe455e21a085ae195a097cd4f456051a9916a5064

Support

Please check the FAQ first! Also at least have a short look at the recent chat history.

You can report in our Telegram group or via issue tracker on Github (account required).

Telegram group (international): @SmartTubeEN
Telegram group (RU/UA): @SmartTubeUA
Email: first.hash at gmail dot com

The international group is in English only. But don't worry if your English is not perfect, we have a friendly international community.

Team

SmartTube is developed single-handedly; there is no larger team or company behind this. This is an open source, hobby project. Several others have helped with translations, some of which can be seen on Github, some have sent their translations directly to Yurii. There are also helpful people in the support chat.

Build

NOTE: OpenJDK 14 or older (!) is required. Newer JDK could cause app crash!
To build and install debug version, run these commands:

git clone https://github.com/yuliskov/SmartTubeNext.git
cd SmartTubeNext
git submodule update --init
adb connect <device_ip_address>
gradlew clean installStorigDebug

Video codecs

Video codecs are the algorithms used for video compression.

Which codec to choose / overview

	recommendation	hardware support	compression, bitrate*	quality
AV01 aka. AV1	best choice, if your device supports	first devices started coming in 2020	best (e.g. 1.6 Mbps)	same
VP9	best choice on most devices	most devices since 2015	better (e.g. 2.1 Mbps)	same
AVC	only for old or slow hardware	all devices	good (e.g. 2.7 Mbps)	same

* Examples taken from the video-only track at 1080p @ 25fps for this video: Dua Lipa - New Rules (Official Music Video)

At the same resolution, a lower bitrate is better! YouTube explicitly targets the same quality regardless of the codec. Older codecs have a higher bitrate only because they are less efficient. On Youtube, you do not get better quality by simply choosing a higher bitrate. Newer codecs have a better compression = lower bitrate = use less bandwidth = save the environment. This is a feature, not a bug. You should use the newest codec that works smoothly on your device, not the least efficient one. AVC usually has the highest bitrate. This is bad, not good.

Which quality to choose?

Currently, there is no automatic mode based on your bandwidth. But you can configure a default video preset yourself under settings > video player > video presets. The first option ("none") will remember your last selection within the video player. Any other preset is used initially for each video; if the selected profile is not available, the next best available option is used. You can still override the profile on each video individually within the player.

To decide the optional resolution / video quality for you, you need to consider a few limiting factors:

your bandwidth (choose only up to the bitrate that your bandwidth can handle; you can do a speedtest using fast.com by Netflix)
your TV's display resolution (the quality might slightly improve, if you select the next higher resolution, e.g. 1080p on a 720p display; but don't expect a big difference)
your TV's capabilities (e.g. HDR, 60fps)

Generally 60fps is an improvement, but if you personally don't notice (or mind) the difference, you can save bandwidth (and the environment) by not choosing 60fps.

HDR

HDR works only if your hardware supports it. It's a complicated mess.

Your TV must support it
If you use a TV box, that TV box and your TV cable and the TV must support HDR
Yes, there truly are different HDMI cable versions with different HDR-support, it's complicated
some devices (like the NVIDIA Shield) generally support HDR, but not the specific HDR format that is used on YouTube 😢

If HDR videos look looked dim or washed out, then check this article. If HDR is not working, it's probably not this app's fault. You might need to search on the web for "HDR" and your device name for any help.

Liability

We take no responsibility for the use of our tool, or external instances provided by third parties. We strongly recommend you abide by the valid official regulations in your country. Furthermore, we refuse liability for any inappropriate use of Invidious, such as illegal downloading. This tool is provided to you in the spirit of free, open software.

You may view the LICENSE in which this software is provided to you here.

Limitation of Liability.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

FAQ

Q: There is no result for the search that I say (Android 11)

A: They're some reports that the latest update for "Google app for Android TV" could cause this bug. Deleting the update should fix the problem.

Q: AV01 does not play / Why is VP9 slow on my device?

A: Because AV01 is very new, most TVs and TV boxes not not offer hardware support and cannot play AV01 at all.

If your device has hardware support for a codec, videos using that codec should play smoothly. High resolutions might also be slow in VP9 on cheap TV boxes that don't officially support 4k. Your device probably can play VP9 videos even without hardware support, however this requires a powerful CPU to run smoothly. Fixing AV01 without hardware support is technically possible, but currently not planned and probably not efficient enough.

Q: Can you make SmartTube look like the original app?

A: Compared to SmartTube's UI, Stock Youtube and YT Kids are far ahead. However, we'd need someone who's skilled and willing to dedicate enough time and energy into making it. And into maintaining it longterm (incl. new features, bug fixes). All of this for free. If you are / got someone like that, please help. Not to mention that SmartTube follows Google's official template & recommendations for Android TV apps. It's Google's fault that the template is somewhat ugly. 😂

Q: Can the search page be improved?

A: It can be, but it takes someone to do it, similar to the above FAQ-entry. SmartTube is following Google's officially recommended design/template for TV apps and is using the official, preinstalled Android TV keyboard. Sadly, Google did a really bad job regarding the search page and keyboard. Maybe a future SmartTube update can add an embedded keyboard, similar to the original YouTube or other major Android TV apps. Maybe it can improve the looks to be as good or better than in the official YouTube app. But for now, it is the way it is due to lack of time and due to Google's official recommendations being bad.

Q: Can I install this on a Samsung Tizen TV / LG webOS TV / Roku / iOS / toaster?

A: No, this only works on Android devices. If you look at an Android TV's product page, it usually says clearly that it's based on Android. The app cannot easily be ported over to other plattforms and we have no plans to even try. Please do not ask. Instead, you can connect a separate TV stick or TV box to your TV.

Q: Can I install this on a smartphone? / Can you add portrait mode? / Scrolling doesn't work.

A: Big No. This app is not for smartphones, we offer zero support for that.

You can cast videos from your smartphone to a TV / TV box running SmartTube, though. Just use the official YouTube app or ReVanced, see the casting section for more information.

There will not be a phone version. You can use ReVanced, Pure Tuber, NewPipe, or NewPipe x SponsorBlock instead. Please go to their respective support chats for help.

Q: Can I install this on a tablet / car screen / smartphone with docking station?

Yes... maybe.. Requirements:

it is an Android device
it has a large screen
it has a TV remote, controller, or keyboard Touch input and is not supported. Mouse/touchpad scrolling neither. You cannot properly use SmartTube with only touch or mouse input.

Some users reported great success (incl. on a car entertainment system). Please share your success stories with us.

Q: I get "unknown codec" / "can't download video" errors

A: please wait 5 seconds for the video to play. If that doesn't help, press the play button. Some users reported, that this issue only appears when they have a USB audio device attached or if their disk storage is full.

Q: I get "the video profile is not supported"

A. Press the "HQ"-button in the bottom-left, select video formats and select anything other than AV01. AV01 is not supported on most devices (apparently including yours), so select VP9 instead. See the section on video codecs for more information.

Q: I get "video unavailable" when watching unlisted videos / my own videos

A: Right, that's currently a bug.

Q: It doesn't show up on my casting list

A: Please read the Casting section.

Q: The video is buffering a lot

A: The issue might not be specific to SmartTube, as other unofficial YouTube apps also report this issue. It seems uncommon nowadays, but was very present in the 2nd quarter of 2021. Some users or devices seem to be more affected then others. The official YouTube app & website are apparently only rarely affected. The root cause of the issue is currently unclear, but it appears to be a server-side thing on YouTube's end. Possibly, YouTube is discriminating 3rd party apps.

For now, try to see if it helps to:

reduce the resolution (or chance it back)
change the video format to AVC
increase the buffer in the settings
hit the back button and try playing the video again

Q: The debug information says my display is 1080p, but I have a 4k/UHD display!

A: Do not worry, the debug information is incorrect. SmartTube works fine even above 1080p and you should be able to see that, when you play a video in 4k or UHD. Also do not worry if it says "720p" and you have a 1080p display.

Q: Why does it not autoselect highest quality?

A: It does (by default). If you set a video profile under settings, that acts as a maximum for automatic selection. Check if you configured a video profile, you can unset it by choosing "none".

Please do not confuse quality with bitrate. See the section on video codecs for more information.

Q: Can I set a (maximum) resolution by default?

A: SmartTube automatically select the highest available quality for your video, up to a maximum resolution that you can set in the settings under "video profile". If available, SmartTube will pick the selected video profile, or otherwise the next best one available will be used. You can still always change the video profile while watching videos.

Q: Can it set the resolution to "auto", depending on my available bandwidth?

A: This is planned, but not available yet (sorry 🙇‍♀️). However, you can set a maximum resolution to something that should work for your bandwidth. See above for details.

Q: Why does it skip video segments?

A: SmartTube has a feature called SponsorBlock. You can select categories should be skipped, if any. See the SponsorBlock section for more details.

Q: How to start the next video automatically / stop after every video?

A: You can switch between different autoplay-modes using the loop-button 🔁

Q: How to remove recommended videos (e.g. news) that are unrelated to me?

A: Recommended videos are defined by YouTube and not by the app, we cannot change the algorithm. They are based on your country, which you can change in the settings. If you are logged in, they are based on your watch history, user profile data, and whatever else Google might use. If you are not logged in, you are like in "incognito mode", so your watch history does not influence your recommendations. Maybe a future version will add optional user profiling without logging in.

Q: Does HDR work?

A: Yes, HDR works if your hardware supports it. The NVIDIA Shield does not. See the section on HDR for more information.

Q: Why do some updates say "don't update if satisfied with the current version" in the changelog?

A: These updates change a lot of code, trying to fix bugs that only affect a few users/devices. Only the affected users should update. For anyone else, there is nothing to gain from updating; however there is the chance of causing new bugs. Do not worry if you updated anyways.

Q: When playing at other speeds, frames are skipped!

A: We currently cannot fix this, sorry.

Q: What is AFR?

A: "Auto Frame Rate". It adjusts the refresh rate of your TV to match the content you're watching. It can slightly improve the smoothness, but the difference is very small; most people barely notice it. It does not work well on every hardware. If you don't know what it does and don't want to test it out yourself, you can safely keep it off.

Recommendation: You can turn it on to see if it works on your device; if it causes issues (or if you don't care to test), turn it off.

Q: Should I choose high or low buffer?

A: The higher your buffer, the more of a video will be preloaded ahead of your current position. A low buffer might minimally reduce your bandwidth usage, if you often close videos before they end. A high buffer can smooth out network issues and prevent the video from pausing to buffer. A higher buffer increases RAM usage, however this shouldn't be an issue.

Recommendation: high.

Q: Can I retain the buffer when seeking back?

A: No, when you seek back (e.g. jump back 5 seconds), SmartTube will have to rebuffer. This might be improved in a future update.

Q: My device freezes when watching YouTube

A: That's a firmware or Android issue. If you are using a custom rom, maybe that rom is buggy. Because this issue is nearly impossible for the developer to debug, we cannot help you, sorry. You can try the usual workarounds: rebooting, clearing cache, reinstalling the app, or factory resetting the device.

Q: Can I remove videos from the history?

A: not yet

Q: Can I download videos?

A: not with SmartTube

Q: Can updates be installed automatically?

A: no, this is technically not possible. Only the preinstalled app manager (usually Google PlayStore, Amazon AppStore, etc) has the required permission. All other apps, incl. SmartTube can only show open installation prompt. A workaround using root would be possible, but hasn't been implemented yet.

Q: Can I whitelist ads on some channels?

A: no, this is not possible. SmartTube does not have any code to display ads. Adding this functionality would actually take time and effort, which is instead spent on adding useful features and fixing bugs.

mollyim/mollyim-android

2023-10-16T01:30:06Z

A fork of Signal for Android with passphrase lock

Molly

Molly is a hardened version of Signal for Android, the fast simple yet secure messaging app by Signal Foundation.

Introduction

Back in 2018, Signal allowed the user to set a passphrase to secure the local message database. But this option was removed with the introduction of file-based encryption on Android. Molly brings it back again with additional security features.

Molly connects to the Signal server, so you can chat with your Signal contacts seamlessly. Please remember to review the Signal Terms & Privacy Policy before signing up.

We update Molly every two weeks to include the latest features and bug fixes from Signal. The exceptions are security issues, which are patched as soon as fixes become available.

Download

You can download the app from GitHub's Releases page or install it from the Molly F-Droid Repo:

There are two flavors to choose from download: Molly or Molly-FOSS. Learn the differences below and download the right one for you.

You can also download Molly-FOSS from Accrescent:

Signing certificate fingerprints to verify the APK:

SHA-256: 6aa80fdf4a8cc13737cfb434fc0cde486f09cf8fcda21a67bea5ee1ca2700886
SHA-1: 49ce310cdd0c09c8c34eb31a8005c6bf13f5a4f1

To explore latest experimental features, consider Molly Insider, our dedicated app for beta testing. Find out more here: Molly Insider on GitHub.

Features

Molly has unique features compared to Signal:

Data encryption at rest - Protect the database with passphrase encryption
Secure RAM wiper - Securely shred sensitive data from device memory
Automatic lock - Lock the app automatically under certain conditions
Multi-device support -- Link multiple devices, including Android tablets, to a single account
Block unknown contacts - Block messages and calls from unknown senders for security and anti-spam
Contact deletion - Allows you to delete contacts and stop sharing your profile
Disappearing call history - Clear call notifications together with expiring messages
Debug logs are optional - Android logging can be disabled
Custom backup scheduling - Choose between a daily or weekly interval and the number of backups to retain
SOCKS proxy and Tor support - Tunnel app network traffic via proxy and Orbot

Besides that, you will find all the features of Signal plus some minor tweaks and improvements. As with Signal, SMS is not supported.

Free and Open-Source

Molly is open-source just like Signal. But Signal uses Google's proprietary software to provide some key features.

To support a 100% free and auditable app, Molly comes in two flavors: one with proprietary blobs like Signal and one without. They are called Molly and Molly-FOSS, respectively. You can install the flavor of your choice at any time, and it will replace any previously installed version. The data and settings will be preserved so that you do not have to re-register.

This table lists the current status of the dependencies:

Feature	Molly-FOSS	Molly	Signal
Push notifications ^{(1) (2)}	✔️ Websocket	⚠️ FCM ✔️ Websocket	⚠️ FCM ✔️ Websocket
Location provider	✔️ OpenStreetMap	⚠️ Google Maps	⚠️️️ Google Maps

⁽¹⁾ You may need to disable the system battery optimizations to receive Websocket-based push notifications in background.
⁽²⁾ If you are running a custom operating system and the app fails to register with Play Services (FCM) try the FOSS flavor.

Compatibility with Signal

Molly and Signal apps can be installed on the same device. If you need a 2nd number to chat, you can use Molly along with Signal.

However, you cannot use the same phone number on both apps at the same time. Only the last app registered will remain active, and the other will go offline. Remember that you are not limited to use only your main phone number - you can use any number on which you can receive SMS or phone calls at registration.

If you are currently a Signal user and want to use Molly instead of Signal (with the same phone number), see Migrating From Signal on the wiki.

Backups

Backups are fully compatible. Signal backups can be restored in Molly, and the other way around, simply by choosing the backup folder and file. However, to import a backup from Signal you must use a matching or newer version of Molly.

For older releases of Android, you might need to rename the backup file and copy it into the expected path, so the app can find the backup to restore during installation. These are the locations within internal storage where backups are written by default:

Signal/Backups/Signal-year-month-date-time.backup
Molly/Backups/Molly-year-month-date-time.backup

Feedback

Submit bugs and feature requests
Join us at #mollyim:matrix.org on Matrix
For news, tips and tricks follow @mollyimapp on Twitter

Reproducible Builds

Molly supports reproducible builds, so that anyone can run the build process to reproduce the same APK as the original release.

Please check the guide in the reproducible-builds directory.

Changelog

See the Changelog to view recent changes.

License

License and legal notices in the original README.

Disclaimer

This project is NOT sponsored by Signal Messenger or Signal Foundation.

The software is produced independently of Signal and carries no guarantee about quality, security or anything else. Use at your own risk.

jMonkeyEngine/jmonkeyengine

2023-10-16T01:30:06Z

A complete 3-D game development suite written in Java.

jMonkeyEngine

jMonkeyEngine is a 3-D game engine for adventurous Java developers. It’s open-source, cross-platform, and cutting-edge. v3.6.1 is the latest stable version of the engine.

The engine is used by several commercial game studios and computer-science courses. Here's a taste:

Getting started

Go to https://github.com/jMonkeyEngine/sdk/releases to download the jMonkeyEngine SDK. Read the wiki for a complete install guide. Power up with some SDK Plugins and AssetPacks and you are off to the races. At this point you're gonna want to join the forum so our tribe can grow stronger.

Note: The master branch on GitHub is a development version of the engine and is NOT MEANT TO BE USED IN PRODUCTION, it will break constantly during development of the stable jME versions!

Technology Stack

Java
NetBeans Platform
Gradle

Plus a bunch of awesome libraries & tight integrations like Bullet, NiftyGUI and other goodies.

Documentation

Did you miss it? Don't sweat it, here it is again.

Contributing

Read our contribution guide.

License

New BSD (3-clause) License

safak/animated-portfolio

2023-10-16T01:30:16Z

Postgres.js - The Fastest full featured PostgreSQL client for Node.js, Deno, Bun and CloudFlare

🚀 Fastest full-featured node & deno client
🏷 ES6 Tagged Template Strings at the core
🏄‍♀️ Simple surface API
🖊️ Dynamic query support
💬 Chat and help on Gitter
🐦 Follow on Twitter

Getting started

Installation

$ npm install postgres

Usage

Create your sql database instance

// db.js
import postgres from 'postgres'

const sql = postgres({ /* options */ }) // will use psql environment variables

export default sql

Simply import for use elsewhere

// users.js
import sql from './db.js'

async function getUsersOver(age) {
  const users = await sql`
    select
      name,
      age
    from users
    where age > ${ age }
  `
  // users = Result [{ name: "Walter", age: 80 }, { name: 'Murray', age: 68 }, ...]
  return users
}


async function insertUser({ name, age }) {
  const users = await sql`
    insert into users
      (name, age)
    values
      (${ name }, ${ age })
    returning name, age
  `
  // users = Result [{ name: "Murray", age: 68 }]
  return users
}

Connection

`postgres([url], [options])`

You can use either a postgres:// url connection string or the options to define your database connection properties. Options in the object will override any present in the url. Options will fall back to the same environment variables as psql.

const sql = postgres('postgres://username:password@host:port/database', {
  host                 : '',            // Postgres ip address[s] or domain name[s]
  port                 : 5432,          // Postgres server port[s]
  database             : '',            // Name of database to connect to
  username             : '',            // Username of database user
  password             : '',            // Password of database user
  ...and more
})

More options can be found in the Connection details section.

Queries

await sql`...` -> Result[]

Postgres.js utilizes Tagged template functions to process query parameters before interpolation. Using tagged template literals benefits developers by:

Enforcing safe query generation
Giving the sql`` function powerful utility and query building features.

Any generic value will be serialized according to an inferred type, and replaced by a PostgreSQL protocol placeholder $1, $2, .... The parameters are then sent separately to the database which handles escaping & casting.

All queries will return a Result array, with objects mapping column names to each row.

const xs = await sql`
  insert into users (
    name, age
  ) values (
    'Murray', 68
  )

  returning *
`

// xs = [{ user_id: 1, name: 'Murray', age: 68 }]

Please note that queries are first executed when awaited – or instantly by using .execute().

Query parameters

Parameters are automatically extracted and handled by the database so that SQL injection isn't possible. No special handling is necessary, simply use tagged template literals as usual.

const name = 'Mur'
    , age = 60

const users = await sql`
  select
    name,
    age
  from users
  where
    name like ${ name + '%' }
    and age > ${ age }
`
// users = [{ name: 'Murray', age: 68 }]

Be careful with quotation marks here. Because Postgres infers column types, you do not need to wrap your interpolated parameters in quotes like '${name}'. This will cause an error because the tagged template replaces ${name} with $1 in the query string, leaving Postgres to do the interpolation. If you wrap that in a string, Postgres will see '$1' and interpret it as a string as opposed to a parameter.

Dynamic column selection

const columns = ['name', 'age']

sql`
  select
    ${ sql(columns) }
  from users
`

// Which results in:
select "name", "age" from users

Dynamic inserts

const user = {
  name: 'Murray',
  age: 68
}

await sql`
  insert into users ${
    sql(user, 'name', 'age')
  }
`

// Which results in:
insert into users ("name", "age") values ($1, $2)

// The columns can also be given with an array
const columns = ['name', 'age']

await sql`
  insert into users ${
    sql(user, columns)
  }
`

You can omit column names and simply execute sql(user) to get all the fields from the object as columns. Be careful not to allow users to supply columns that you do not want to be inserted.

Multiple inserts in one query

If you need to insert multiple rows at the same time it's also much faster to do it with a single insert. Simply pass an array of objects to sql().

const users = [{
  name: 'Murray',
  age: 68,
  garbage: 'ignore'
},
{
  name: 'Walter',
  age: 80
}]

sql`insert into users ${ sql(users, 'name', 'age') }`

// Is translated to:
insert into users ("name", "age") values ($1, $2), ($3, $4)

// Here you can also omit column names which will use object keys as columns
sql`insert into users ${ sql(users) }`

// Which results in:
insert into users ("name", "age") values ($1, $2), ($3, $4)

Dynamic columns in updates

This is also useful for update queries

const user = {
  id: 1,
  name: 'Murray',
  age: 68
}

await sql`
  update users set ${
    sql(user, 'name', 'age')
  }
  where user_id = ${ user.id }
`

// Which results in:
update users set "name" = $1, "age" = $2 where user_id = $3

// The columns can also be given with an array
const columns = ['name', 'age']

await sql`
  update users set ${
    sql(user, columns)
  }
  where user_id = ${ user.id }
`

Multiple updates in one query

To create multiple updates in a single query, it is necessary to use arrays instead of objects to ensure that the order of the items correspond with the column names.

const users = [
  [1, 'John', 34],
  [2, 'Jane', 27],
]

sql`
  update users set name = update_data.name, (age = update_data.age)::int
  from (values ${sql(users)}) as update_data (id, name, age)
  where users.id = (update_data.id)::int
  returning users.id, users.name, users.age
`

Dynamic values and `where in`

Value lists can also be created dynamically, making where in queries simple too.

const users = await sql`
  select
    *
  from users
  where age in ${ sql([68, 75, 23]) }
`

const [{ a, b, c }] => await sql`
  select
    *
  from (values ${ sql(['a', 'b', 'c']) }) as x(a, b, c)
`

Building queries

Postgres.js features a simple dynamic query builder by conditionally appending/omitting query fragments. It works by nesting sql`` fragments within other sql`` calls or fragments. This allows you to build dynamic queries safely without risking sql injections through usual string concatenation.

Partial queries

const olderThan = x => sql`and age > ${ x }`

const filterAge = true

sql`
  select
   *
  from users
  where name is not null ${
    filterAge
      ? olderThan(50)
      : sql``
  }
`
// Which results in:
select * from users where name is not null
// Or
select * from users where name is not null and age > 50

Dynamic filters

sql`
  select
    *
  from users ${
    id
      ? sql`where user_id = ${ id }`
      : sql``
  }
`

// Which results in:
select * from users
// Or
select * from users where user_id = $1

SQL functions

Using keywords or calling functions dynamically is also possible by using sql`` fragments.

const date = null

sql`
  update users set updated_at = ${ date || sql`now()` }
`

// Which results in:
update users set updated_at = now()

Table names

Dynamic identifiers like table names and column names is also supported like so:

const table = 'users'
    , column = 'id'

sql`
  select ${ sql(column) } from ${ sql(table) }
`

// Which results in:
select "id" from "users"

Quick primer on interpolation

Here's a quick oversight over all the ways to do interpolation in a query template string:

Interpolation syntax	Usage	Example
${ sql`` }	for keywords or sql fragments	sql`SELECT * FROM users ${sql`order by age desc` }`
`${ sql(string) }`	for identifiers	sql`SELECT * FROM ${sql('table_name')`
`${ sql([] or {}, ...) }`	for helpers	sql`INSERT INTO users ${sql({ name: 'Peter'})}`
`${ 'somevalue' }`	for values	sql`SELECT * FROM users WHERE age = ${42}`

Advanced query methods

Cursors

await sql``.cursor([rows = 1], [fn])

Use cursors if you need to throttle the amount of rows being returned from a query. You can use a cursor either as an async iterable or with a callback function. For a callback function new results won't be requested until the promise / async callback function has resolved.

callback function

await sql`
  select
    *
  from generate_series(1,4) as x
`.cursor(async([row]) => {
  // row = { x: 1 }
  await http.request('https://example.com/wat', { row })
})

for await...of

// for await...of
const cursor = sql`select * from generate_series(1,4) as x`.cursor()

for await (const [row] of cursor) {
  // row = { x: 1 }
  await http.request('https://example.com/wat', { row })
}

A single row will be returned by default, but you can also request batches by setting the number of rows desired in each batch as the first argument to .cursor:

await sql`
  select
    *
  from generate_series(1,1000) as x
`.cursor(10, async rows => {
  // rows = [{ x: 1 }, { x: 2 }, ... ]
  await Promise.all(rows.map(row =>
    http.request('https://example.com/wat', { row })
  ))
})

If an error is thrown inside the callback function no more rows will be requested and the outer promise will reject with the thrown error.

You can close the cursor early either by calling break in the for await...of loop, or by returning the token sql.CLOSE from the callback function.

await sql`
  select * from generate_series(1,1000) as x
`.cursor(row => {
  return Math.random() > 0.9 && sql.CLOSE // or sql.END
})

Instant iteration

await sql``.forEach(fn)

If you want to handle rows returned by a query one by one, you can use .forEach which returns a promise that resolves once there are no more rows.

await sql`
  select created_at, name from events
`.forEach(row => {
  // row = { created_at: '2019-11-22T14:22:00Z', name: 'connected' }
})

// No more rows

Query Descriptions

await sql``.describe() -> Result[]

Rather than executing a given query, .describe will return information utilized in the query process. This information can include the query identifier, column types, etc.

This is useful for debugging and analyzing your Postgres queries. Furthermore, .describe will give you access to the final generated query string that would be executed.

Rows as Array of Values

sql``.values()

Using .values will return rows as an array of values for each column, instead of objects.

This can be useful to receive identically named columns, or for specific performance/transformation reasons. The column definitions are still included on the result array, plus access to parsers for each column.

Rows as Raw Array of Buffers

sql``.raw()

Using .raw will return rows as an array with Buffer values for each column, instead of objects.

This can be useful for specific performance/transformation reasons. The column definitions are still included on the result array, plus access to parsers for each column.

Queries in Files

`await sql.file(path, [args], [options]) -> Result[]`

Using a file for a query is also supported with optional parameters to use if the file includes $1, $2, etc

const result = await sql.file('query.sql', ['Murray', 68])

Multiple statements in one query

await sql``.simple()

The postgres wire protocol supports "simple" and "extended" queries. "simple" queries supports multiple statements, but does not support any dynamic parameters. "extended" queries support parameters but only one statement. To use "simple" queries you can use sql``.simple(). That will create it as a simple query.

await sql`select 1; select 2;`.simple()

Copy to/from as Streams

Postgres.js supports COPY ... queries, which are exposed as Node.js streams.

await sql`copy ... from stdin`.writable() -> Writable

import { pipeline } from 'node:stream/promises'

// Stream of users with the default tab delimitated cells and new-line delimitated rows
const userStream = Readable.from([
  'Murray\t68\n',
  'Walter\t80\n'
])

const query = await sql`copy users (name, age) from stdin`.writable()
await pipeline(userStream, query);

await sql`copy ... to stdout`.readable() -> Readable

Using Stream Pipeline

import { pipeline } from 'node:stream/promises'
import { createWriteStream } from 'node:fs'

const readableStream = await sql`copy users (name, age) to stdout`.readable()
await pipeline(readableStream, createWriteStream('output.tsv'))
// output.tsv content: `Murray\t68\nWalter\t80\n`

Using `for await...of`

const readableStream = await sql`
  copy (
    select name, age 
    from users 
    where age = 68
  ) to stdout
`.readable()
for await (const chunk of readableStream) {
  // chunk.toString() === `Murray\t68\n`
}

NOTE This is a low-level API which does not provide any type safety. To make this work, you must match your copy query parameters correctly to your Node.js stream read or write code. Ensure Node.js stream backpressure is handled correctly to avoid memory exhaustion.

Canceling Queries in Progress

Postgres.js supports, canceling queries in progress. It works by opening a new connection with a protocol level startup message to cancel the current query running on a specific connection. That means there is no guarantee that the query will be canceled, and due to the possible race conditions it might even result in canceling another query. This is fine for long running queries, but in the case of high load and fast queries it might be better to simply ignore results instead of canceling.

const query = sql`select pg_sleep 100`.execute()
setTimeout(() => query.cancel(), 100)
const result = await query

Execute

await sql``.execute()

The lazy Promise implementation in Postgres.js is what allows it to distinguish Nested Fragments from the main outer query. This also means that queries are always executed at the earliest in the following tick. If you have a specific need to execute the query in the same tick, you can call .execute()

Unsafe raw string queries

Advanced unsafe use cases

`await sql.unsafe(query, [args], [options]) -> Result[]`

If you know what you're doing, you can use unsafe to pass any string you'd like to postgres. Please note that this can lead to SQL injection if you're not careful.

sql.unsafe('select ' + danger + ' from users where id = ' + dragons)

You can also nest sql.unsafe within a safe sql expression. This is useful if only part of your fraction has unsafe elements.

const triggerName = 'friend_created'
const triggerFnName = 'on_friend_created'
const eventType = 'insert'
const schema_name = 'app'
const table_name = 'friends'

await sql`
  create or replace trigger ${sql(triggerName)}
  after ${sql.unsafe(eventType)} on ${sql.unsafe(`${schema_name}.${table_name}`)}
  for each row
  execute function ${sql(triggerFnName)}()
`

await sql`
  create role friend_service with login password ${sql.unsafe(`'${password}'`)}
`

Transactions

BEGIN / COMMIT `await sql.begin([options = ''], fn) -> fn()`

Use sql.begin to start a new transaction. Postgres.js will reserve a connection for the transaction and supply a scoped sql instance for all transaction uses in the callback function. sql.begin will resolve with the returned value from the callback function.

BEGIN is automatically sent with the optional options, and if anything fails ROLLBACK will be called so the connection can be released and execution can continue.

const [user, account] = await sql.begin(async sql => {
  const [user] = await sql`
    insert into users (
      name
    ) values (
      'Murray'
    )
  returning *
  `

  const [account] = await sql`
    insert into accounts (
      user_id
    ) values (
      ${ user.user_id }
    )
  returning *
  `

  return [user, account]
})

Do note that you can often achieve the same result using WITH queries (Common Table Expressions) instead of using transactions.

It's also possible to pipeline the requests in a transaction if needed by returning an array with queries from the callback function like this:

const result = await sql.begin(sql => [
  sql`update ...`,
  sql`update ...`,
  sql`insert ...`
])

SAVEPOINT `await sql.savepoint([name], fn) -> fn()`

sql.begin('read write', async sql => {
  const [user] = await sql`
    insert into users (
      name
    ) values (
      'Murray'
    )
  `

  const [account] = (await sql.savepoint(sql =>
    sql`
      insert into accounts (
        user_id
      ) values (
        ${ user.user_id }
      )
    `
  ).catch(err => {
    // Account could not be created. ROLLBACK SAVEPOINT is called because we caught the rejection.
  })) || []

  return [user, account]
})
.then(([user, account]) => {
  // great success - COMMIT succeeded
})
.catch(() => {
  // not so good - ROLLBACK was called
})

PREPARE TRANSACTION `await sql.prepare([name]) -> fn()`

Indicates that the transactions should be prepared using the PREPARE TRANSACTION [NAME] statement instead of being committed.

sql.begin('read write', async sql => {
  const [user] = await sql`
    insert into users (
      name
    ) values (
      'Murray'
    )
  `
    
  await sql.prepare('tx1')
})

Data Transformation

Postgres.js allows for transformation of the data passed to or returned from a query by using the transform option.

Built in transformation functions are:

For camelCase - postgres.camel, postgres.toCamel, postgres.fromCamel
For PascalCase - postgres.pascal, postgres.toPascal, postgres.fromPascal
For Kebab-Case - postgres.kebab, postgres.toKebab, postgres.fromKebab

These built in transformations will only convert to/from snake_case. For example, using { transform: postgres.toCamel } will convert the column names to camelCase only if the column names are in snake_case to begin with. { transform: postgres.fromCamel } will convert camelCase only to snake_case.

By default, using postgres.camel, postgres.pascal and postgres.kebab will perform a two-way transformation - both the data passed to the query and the data returned by the query will be transformed:

// Transform the column names to and from camel case
const sql = postgres({ transform: postgres.camel })

await sql`CREATE TABLE IF NOT EXISTS camel_case (a_test INTEGER, b_test TEXT)`
await sql`INSERT INTO camel_case ${ sql([{ aTest: 1, bTest: 1 }]) }`
const data = await sql`SELECT ${ sql('aTest', 'bTest') } FROM camel_case`

console.log(data) // [ { aTest: 1, bTest: '1' } ]

To only perform half of the transformation (eg. only the transformation to or from camel case), use the other transformation functions:

// Transform the column names only to camel case
// (for the results that are returned from the query)
postgres({ transform: postgres.toCamel })

await sql`CREATE TABLE IF NOT EXISTS camel_case (a_test INTEGER)`
await sql`INSERT INTO camel_case ${ sql([{ a_test: 1 }]) }`
const data = await sql`SELECT a_test FROM camel_case`

console.log(data) // [ { aTest: 1 } ]

// Transform the column names only from camel case
// (for interpolated inserts, updates, and selects)
const sql = postgres({ transform: postgres.fromCamel })

await sql`CREATE TABLE IF NOT EXISTS camel_case (a_test INTEGER)`
await sql`INSERT INTO camel_case ${ sql([{ aTest: 1 }]) }`
const data = await sql`SELECT ${ sql('aTest') } FROM camel_case`

console.log(data) // [ { a_test: 1 } ]

Note that Postgres.js does not rewrite the static parts of the tagged template strings. So to transform column names in your queries, the sql() helper must be used - eg. ${ sql('columnName') } as in the examples above.

Transform `undefined` Values

By default, Postgres.js will throw the error UNDEFINED_VALUE: Undefined values are not allowed when undefined values are passed

// Transform the column names to and from camel case
const sql = postgres({
  transform: {
    undefined: null
  }
})

await sql`CREATE TABLE IF NOT EXISTS transform_undefined (a_test INTEGER)`
await sql`INSERT INTO transform_undefined ${ sql([{ a_test: undefined }]) }`
const data = await sql`SELECT a_test FROM transform_undefined`

console.log(data) // [ { a_test: null } ]

To combine with the built in transform functions, spread the transform in the transform object:

// Transform the column names to and from camel case
const sql = postgres({
  transform: {
    ...postgres.camel,
    undefined: null
  }
})

await sql`CREATE TABLE IF NOT EXISTS transform_undefined (a_test INTEGER)`
await sql`INSERT INTO transform_undefined ${ sql([{ aTest: undefined }]) }`
const data = await sql`SELECT ${ sql('aTest') } FROM transform_undefined`

console.log(data) // [ { aTest: null } ]

Custom Transform Functions

To specify your own transformation functions, you can use the column, value and row options inside of transform, each an object possibly including to and from keys:

to: The function to transform the outgoing query column name to, i.e SELECT ${ sql('aName') } to SELECT a_name when using postgres.toCamel.
from: The function to transform the incoming query result column name to, see example below.

Both parameters are optional, if not provided, the default transformation function will be used.

// Implement your own functions, look at postgres.toCamel, etc
// as a reference:
// https://github.com/porsager/postgres/blob/4241824ffd7aa94ffb482e54ca9f585d9d0a4eea/src/types.js#L310-L328
function transformColumnToDatabase() { /* ... */ }
function transformColumnFromDatabase() { /* ... */ }

const sql = postgres({
  transform: {
    column: {
      to: transformColumnToDatabase,
      from: transformColumnFromDatabase,
    },
    value: { /* ... */ },
    row: { /* ... */ }
  }
})

Listen & notify

When you call .listen, a dedicated connection will be created to ensure that you receive notifications instantly. This connection will be used for any further calls to .listen. The connection will automatically reconnect according to a backoff reconnection pattern to not overload the database server.

Listen `await sql.listen(channel, onnotify, [onlisten]) -> { state }`

.listen takes the channel name, a function to handle each notify, and an optional function to run every time listen is registered and ready (happens on initial connect and reconnects). It returns a promise which resolves once the LISTEN query to Postgres completes, or if there is already a listener active.

await sql.listen('news', payload => {
  const json = JSON.parse(payload)
  console.log(json.this) // logs 'is'
})

The optional onlisten method is great to use for a very simply queue mechanism:

await sql.listen(
  'jobs', 
  (x) => run(JSON.parse(x)),
  ( ) => sql`select unfinished_jobs()`.forEach(run)
)

function run(job) {
  // And here you do the work you please
}

Notify `await sql.notify(channel, payload) -> Result[]`

Notify can be done as usual in SQL, or by using the sql.notify method.

sql.notify('news', JSON.stringify({ no: 'this', is: 'news' }))

Realtime subscribe

Postgres.js implements the logical replication protocol of PostgreSQL to support subscription to real-time updates of insert, update and delete operations.

NOTE To make this work you must create the proper publications in your database, enable logical replication by setting wal_level = logical in postgresql.conf and connect using either a replication or superuser.

Quick start

Create a publication (eg. in migration)

CREATE PUBLICATION alltables FOR ALL TABLES

Subscribe to updates

const sql = postgres({ publications: 'alltables' })

const { unsubscribe } = await sql.subscribe(
  'insert:events', 
  (row, { command, relation, key, old }) => {
    // Callback function for each row change
    // tell about new event row over eg. websockets or do something else
  },
  () => {
    // Callback on initial connect and potential reconnects
  }
)

Subscribe pattern

You can subscribe to specific operations, tables, or even rows with primary keys.

`operation` `:` `schema` `.` `table` `=` `primary_key`

operation is one of * | insert | update | delete and defaults to *

schema defaults to public

table is a specific table name and defaults to *

primary_key can be used to only subscribe to specific rows

Examples

sql.subscribe('*',                () => /* everything */ )
sql.subscribe('insert',           () => /* all inserts */ )
sql.subscribe('*:users',          () => /* all operations on the public.users table */ )
sql.subscribe('delete:users',     () => /* all deletes on the public.users table */ )
sql.subscribe('update:users=1',   () => /* all updates on the users row with a primary key = 1 */ )

Numbers, bigint, numeric

Number in javascript is only able to represent 2⁵³-1 safely which means that types in PostgreSQLs like bigint and numeric won't fit into Number.

Since Node.js v10.4 we can use BigInt to match the PostgreSQL type bigint which is returned for eg. count(*). Unfortunately, it doesn't work with JSON.stringify out of the box, so Postgres.js will return it as a string.

If you want to use BigInt you can add this custom type:

const sql = postgres({
  types: {
    bigint: postgres.BigInt
  }
})

There is currently no guaranteed way to handle numeric / decimal types in native Javascript. These [and similar] types will be returned as a string. The best way in this case is to use custom types.

Result Array

The Result Array returned from queries is a custom array allowing for easy destructuring or passing on directly to JSON.stringify or general Array usage. It includes the following properties.

.count

The count property is the number of affected rows returned by the database. This is usefull for insert, update and delete operations to know the number of rows since .length will be 0 in these cases if not using RETURNING ....

.command

The command run by the query - eg. one of SELECT, UPDATE, INSERT, DELETE

.columns

The columns returned by the query useful to determine types, or map to the result values when using .values()

{
  name  : String,    // Column name,
  type  : oid,       // PostgreSQL oid column type
  parser: Function   // The function used by Postgres.js for parsing
}

.statement

The statement contains information about the statement implicitly created by Postgres.js.

{
  name    : String,  // The auto generated statement name
  string  : String,  // The actual query string executed
  types   : [oid],   // An array of oid expected as input parameters
  columns : [Column] // Array of columns - same as Result.columns
}

.state

This is the state { pid, secret } of the connection that executed the query.

Connection details

All Postgres options

const sql = postgres('postgres://username:password@host:port/database', {
  host                 : '',            // Postgres ip address[es] or domain name[s]
  port                 : 5432,          // Postgres server port[s]
  path                 : '',            // unix socket path (usually '/tmp')
  database             : '',            // Name of database to connect to
  username             : '',            // Username of database user
  password             : '',            // Password of database user
  ssl                  : false,         // true, prefer, require, tls.connect options
  max                  : 10,            // Max number of connections
  max_lifetime         : null,          // Max lifetime in seconds (more info below)
  idle_timeout         : 0,             // Idle connection timeout in seconds
  connect_timeout      : 30,            // Connect timeout in seconds
  prepare              : true,          // Automatic creation of prepared statements
  types                : [],            // Array of custom types, see more below
  onnotice             : fn,            // Default console.log, set false to silence NOTICE
  onparameter          : fn,            // (key, value) when server param change
  debug                : fn,            // Is called with (connection, query, params, types)
  socket               : fn,            // fn returning custom socket to use
  transform            : {
    undefined          : undefined,     // Transforms undefined values (eg. to null)
    column             : fn,            // Transforms incoming column names
    value              : fn,            // Transforms incoming row values
    row                : fn             // Transforms entire rows
  },
  connection           : {
    application_name   : 'postgres.js', // Default application_name
    ...                                 // Other connection parameters
  },
  target_session_attrs : null,          // Use 'read-write' with multiple hosts to
                                        // ensure only connecting to primary
  fetch_types          : true,          // Automatically fetches types on connect
                                        // on initial connection.
})

Note that max_lifetime = 60 * (30 + Math.random() * 30) by default. This resolves to an interval between 45 and 90 minutes to optimize for the benefits of prepared statements and working nicely with Linux's OOM killer.

SSL

Although vulnerable to MITM attacks, a common configuration for the ssl option for some cloud providers is to set rejectUnauthorized to false (if NODE_ENV is production):

const sql =
  process.env.NODE_ENV === 'production'
    ? // "Unless you're using a Private or Shield Heroku Postgres database, Heroku Postgres does not currently support verifiable certificates"
      // https://help.heroku.com/3DELT3RK/why-can-t-my-third-party-utility-connect-to-heroku-postgres-with-ssl
      postgres({ ssl: { rejectUnauthorized: false } })
    : postgres()

For more information regarding ssl with postgres, check out the Node.js documentation for tls.

Multi-host connections - High Availability (HA)

Multiple connection strings can be passed to postgres() in the form of postgres('postgres://localhost:5432,localhost:5433', ...). This works the same as native the psql command. Read more at multiple host URIs.

Connections will be attempted in order of the specified hosts/ports. On a successful connection, all retries will be reset. This ensures that hosts can come up and down seamlessly.

If you specify target_session_attrs: 'primary' or PGTARGETSESSIONATTRS=primary Postgres.js will only connect to the primary host, allowing for zero downtime failovers.

The Connection Pool

Connections are created lazily once a query is created. This means that simply doing const sql = postgres(...) won't have any effect other than instantiating a new sql instance.

No connection will be made until a query is made.

For example:

const sql = postgres() // no connections are opened

await sql`...` // one connection is now opened
await sql`...` // previous opened connection is reused

// two connections are opened now
await Promise.all([
  sql`...`,
  sql`...`
])

When there are high amount of concurrent queries, postgres will open as many connections as needed up until max number of connections is reached. By default max is 10. This can be changed by setting max in the postgres() call. Example - postgres('connectionURL', { max: 20 }).

This means that we get a much simpler story for error handling and reconnections. Queries will be sent over the wire immediately on the next available connection in the pool. Connections are automatically taken out of the pool if you start a transaction using sql.begin(), and automatically returned to the pool once your transaction is done.

Any query which was already sent over the wire will be rejected if the connection is lost. It'll automatically defer to the error handling you have for that query, and since connections are lazy it'll automatically try to reconnect the next time a query is made. The benefit of this is no weird generic "onerror" handler that tries to get things back to normal, and also simpler application code since you don't have to handle errors out of context.

There are no guarantees about queries executing in order unless using a transaction with sql.begin() or setting max: 1. Of course doing a series of queries, one awaiting the other will work as expected, but that's just due to the nature of js async/promise handling, so it's not necessary for this library to be concerned with ordering.

Since this library automatically creates prepared statements, it also has a default max lifetime for connections to prevent memory bloat on the database itself. This is a random interval for each connection between 45 and 90 minutes. This allows multiple connections to independently come up and down without affecting the service.

Connection timeout

By default, connections will not close until .end() is called. However, it may be useful to have them close automatically when:

re-instantiating multiple sql`` instances
using Postgres.js in a Serverless environment (Lambda, etc.)
using Postgres.js with a database service that automatically closes connections after some time (see ECONNRESET issue)

This can be done using the idle_timeout or max_lifetime options. These configuration options specify the number of seconds to wait before automatically closing an idle connection and the maximum time a connection can exist, respectively.

For example, to close a connection that has either been idle for 20 seconds or existed for more than 30 minutes:

const sql = postgres({
  idle_timeout: 20,
  max_lifetime: 60 * 30
})

Cloudflare Workers support

Postgres.js has built-in support for the TCP socket API in Cloudflare Workers, which is on-track to be standardized and adopted in Node.js and other JavaScript runtimes, such as Deno.

You can use Postgres.js directly in a Worker, or to benefit from connection pooling and query caching, via the Hyperdrive service available to Workers by passing the Hyperdrive connectionString when creating a new postgres client as follows:

// Requires Postgres.js 3.4.0 or later
import postgres from 'postgres'

interface Env {
    HYPERDRIVE: Hyperdrive;
}

export default async fetch(req: Request, env: Env, ctx: ExecutionContext) {
    // The Postgres.js library accepts a connection string directly
    const sql = postgres(env.HYPERDRIVE.connectionString)
    const results = await sql`SELECT * FROM users LIMIT 10`
    return Response.json(results)
}

In wrangler.toml you will need to enable node_compat to allow Postgres.js to operate in the Workers environment:

node_compat = true # required for database drivers to function

Auto fetching of array types

Postgres.js will automatically fetch table/array-type information when it first connects to a database.

If you have revoked access to pg_catalog this feature will no longer work and will need to be disabled.

You can disable this feature by setting fetch_types to false.

Environmental variables

It is also possible to connect to the database without a connection string or any options. Postgres.js will fall back to the common environment variables used by psql as in the table below:

const sql = postgres()

Option	Environment Variables
`host`	`PGHOST`
`port`	`PGPORT`
`database`	`PGDATABASE`
`username`	`PGUSERNAME` or `PGUSER`
`password`	`PGPASSWORD`
`idle_timeout`	`PGIDLE_TIMEOUT`
`connect_timeout`	`PGCONNECT_TIMEOUT`

Prepared statements

Prepared statements will automatically be created for any queries where it can be inferred that the query is static. This can be disabled by using the prepare: false option. For instance — this is useful when using PGBouncer in transaction mode.

Custom Types

You can add ergonomic support for custom types, or simply use sql.typed(value, type) inline, where type is the PostgreSQL oid for the type and the correctly serialized string. (oid values for types can be found in the pg_catalog.pg_type table.)

Adding Query helpers is the cleanest approach which can be done like this:

const sql = postgres({
  types: {
    rect: {
      // The pg_types oid to pass to the db along with the serialized value.
      to        : 1337,

      // An array of pg_types oids to handle when parsing values coming from the db.
      from      : [1337],

      //Function that transform values before sending them to the db.
      serialize : ({ x, y, width, height }) => [x, y, width, height],

      // Function that transforms values coming from the db.
      parse     : ([x, y, width, height]) => { x, y, width, height }
    }
  }
})

// Now you can use sql.typed.rect() as specified above
const [custom] = sql`
  insert into rectangles (
    name,
    rect
  ) values (
    'wat',
    ${ sql.typed.rect({ x: 13, y: 37, width: 42, height: 80 }) }
  )
  returning *
`

// custom = { name: 'wat', rect: { x: 13, y: 37, width: 42, height: 80 } }

Custom socket

Easily do in-process ssh tunneling to your database by providing a custom socket for Postgres.js to use. The function (optionally async) must return a socket-like duplex stream.

Here's a sample using ssh2

import ssh2 from 'ssh2'

const sql = postgres({
  ...options,
  socket: ({ host: [host], port: [port] }) => new Promise((resolve, reject) => {
    const ssh = new ssh2.Client()
    ssh
    .on('error', reject)
    .on('ready', () => 
      ssh.forwardOut('127.0.0.1', 12345, host, port, 
        (err, socket) => err ? reject(err) : resolve(socket)
      )
    )
    .connect(sshOptions)
  })
})

Teardown / Cleanup

To ensure proper teardown and cleanup on server restarts use await sql.end() before process.exit().

Calling sql.end() will reject new queries and return a Promise which resolves when all queries are finished and the underlying connections are closed. If a { timeout } option is provided any pending queries will be rejected once the timeout (in seconds) is reached and the connections will be destroyed.

Sample shutdown using Prexit

import prexit from 'prexit'

prexit(async () => {
  await sql.end({ timeout: 5 })
  await new Promise(r => server.close(r))
})

Reserving connections

`await sql.reserve()`

The reserve method pulls out a connection from the pool, and returns a client that wraps the single connection. This can be used for running queries on an isolated connection.

const reserved = await sql.reserve()
await reserved`select * from users`
await reserved.release()

`reserved.release()`

Once you have finished with the reserved connection, call release to add it back to the pool.

Error handling

Errors are all thrown to related queries and never globally. Errors coming from database itself are always in the native Postgres format, and the same goes for any Node.js errors eg. coming from the underlying connection.

Query errors will contain a stored error with the origin of the query to aid in tracing errors.

Query errors will also contain the query string and the parameters. These are not enumerable to avoid accidentally leaking confidential information in logs. To log these it is required to specifically access error.query and error.parameters, or set debug: true in options.

There are also the following errors specifically for this library.

UNSAFE_TRANSACTION

Only use sql.begin or max: 1

To ensure statements in a transaction runs on the same connection (which is required for them to run inside the transaction), you must use sql.begin(...) or only allow a single connection in options (max: 1).

UNDEFINED_VALUE

Undefined values are not allowed

Postgres.js won't accept undefined as values in tagged template queries since it becomes ambiguous what to do with the value. If you want to set something to null, use null explicitly.

MESSAGE_NOT_SUPPORTED

X (X) is not supported

Whenever a message is received from Postgres which is not supported by this library. Feel free to file an issue if you think something is missing.

MAX_PARAMETERS_EXCEEDED

Max number of parameters (65534) exceeded

The postgres protocol doesn't allow more than 65534 (16bit) parameters. If you run into this issue there are various workarounds such as using sql([...]) to escape values instead of passing them as parameters.

SASL_SIGNATURE_MISMATCH

Message type X not supported

When using SASL authentication the server responds with a signature at the end of the authentication flow which needs to match the one on the client. This is to avoid man-in-the-middle attacks. If you receive this error the connection was canceled because the server did not reply with the expected signature.

NOT_TAGGED_CALL

Query not called as a tagged template literal

Making queries has to be done using the sql function as a tagged template. This is to ensure parameters are serialized and passed to Postgres as query parameters with correct types and to avoid SQL injection.

AUTH_TYPE_NOT_IMPLEMENTED

Auth type X not implemented

Postgres supports many different authentication types. This one is not supported.

CONNECTION_CLOSED

write CONNECTION_CLOSED host:port

This error is thrown if the connection was closed without an error. This should not happen during normal operations, so please create an issue if this was unexpected.

CONNECTION_ENDED

write CONNECTION_ENDED host:port

This error is thrown if the user has called sql.end() and performed a query afterward.

CONNECTION_DESTROYED

write CONNECTION_DESTROYED host:port

This error is thrown for any queries that were pending when the timeout to sql.end({ timeout: X }) was reached.

CONNECTION_CONNECT_TIMEOUT

write CONNECTION_CONNECT_TIMEOUT host:port

This error is thrown if the startup phase of the connection (tcp, protocol negotiation, and auth) took more than the default 30 seconds or what was specified using connect_timeout or PGCONNECT_TIMEOUT.

TypeScript support

postgres has TypeScript support. You can pass a row list type for your queries in this way:

interface User {
  id: number
  name: string
}

const users = await sql<User[]>`SELECT * FROM users`
users[0].id // ok => number
users[1].name // ok => string
users[0].invalid // fails: `invalid` does not exists on `User`

However, be sure to check the array length to avoid accessing properties of undefined rows:

const users = await sql<User[]>`SELECT * FROM users WHERE id = ${id}`
if (!users.length)
  throw new Error('Not found')
return users[0]

You can also prefer destructuring when you only care about a fixed number of rows. In this case, we recommend you to prefer using tuples to handle undefined properly:

const [user]: [User?] = await sql`SELECT * FROM users WHERE id = ${id}`
if (!user) // => User | undefined
  throw new Error('Not found')
return user // => User

// NOTE:
const [first, second]: [User?] = await sql`SELECT * FROM users WHERE id = ${id}` // fails: `second` does not exist on `[User?]`
const [first, second] = await sql<[User?]>`SELECT * FROM users WHERE id = ${id}` // don't fail : `second: User | undefined`

We do our best to type all the public API, however types are not always updated when features are added or changed. Feel free to open an issue if you have trouble with types.

Migration tools

Postgres.js doesn't come with any migration solution since it's way out of scope, but here are some modules that support Postgres.js for migrations:

Thank you

A really big thank you to @JAForbes who introduced me to Postgres and still holds my hand navigating all the great opportunities we have.

Thanks to @ACXgit for initial tests and dogfooding.

Also thanks to Ryan Dahl for letting me have the postgres npm package name.

AkankshaAI/Hacktoberfest2023-Beginners-New

2023-10-16T01:30:16Z

This repository accepts PRs for Hacktoberfest2023

HacktoberFest 2023 `OPEN FIRST` Pull Request

This Project Is Perfect For Your First Pull Request

For Hacktoberfest Machine Learning Project Contributions , Click Below

Hacktoberfest Machine Learning Project Repository

🗣 Hacktoberfest encourages participation in the open-source community, which grows bigger every year. Complete the challenge and get a tree planted on your name showing your love towards mother Earth 🌍

📢 Register here for Hacktoberfest and make four pull requests (PRs) between October 1st-31st 🔥.

INSTRUCTIONS for this project for beginners -

Getting started

Fork this repository (Click the Fork button in the top right of this page, click your Profile Image)
You can directly make changes through Github or you can use VScode and commit by following the steps below
Clone your fork down to your local machine

git clone https://github.com/AkankshaAI/Hacktoberfest2023-Beginners-New.git

Create a branch

git checkout -b branch-name

Make your changes (choose from any task below)
Commit and push

git add .
git commit -m 'Commit message'
git push origin branch-name

Create a new pull request from your forked repository (Click the New Pull Request button located at the top of your repo)
Wait for your PR review and merge approval!
Star this repository if you had fun!

How to contribute to this project

Choose from these tasks

1. Add your name

Add your name to the CONTRIBUTING.md file using the below convention:

#### Name: [YOUR NAME](GitHub link)

- Place: City, State, Country
- Bio: Who are you?
- GitHub: [GitHub account name](GitHub link)

2. Add a profile page

Add a Your_Name.md file to the profiles directory. Use any combination of content and Markdown you'd like. Here is an example:

# Your Name

### Location

Your City/Country

### Academics

Your School

### Interests

- Some Things You Like

### Development

- Inventor of the My Pillow

### Projects

- [My Project](GitHub Link) Short Description

### Profile Link

[Your Name](GitHub Link)

3. Create a `Hello, World!` Script

Add a yourusername.xx script to the scripts directory in any language of your choice! Here is an example:

// LANGUAGE: Python
// AUTHOR: Akanksha Rani
// GITHUB: https://github.com/Akanksha Rani

# This program is in python!

print('Hello, Hacktoberfest 2023!')

Name the file hello_world_yourusername.xx. e.g., hello_world_akanksharani.js or hello_world_akanksharani.py.

Add your scripts to the specific folder for specific languages created.

Don't forget to include the comments as seen above. Feel free to include additional information about the language you choose in your comments too! Like a link to a helpful introduction or tutorial.

Here is my hello_world example: Akanksha.py

4.Add top-notch Javascripts Projects in any in 'Top Notch Javascript project folder

Choose one or all 3, make a pull request for your work and wait for it to be merged!

Maintainer

+ Follow Me : } Quick Approval of Pull Request

To get approval of the pull request much quicker and faster (Follow Me)🚀

_{Akanksha Rani}

inrl-official/inrl-bot-md

2023-10-17T01:32:14Z

Simple Whatsapp Bot

INRL Multi Device Whatsapp Bot.

SETUP

Fork The Repo
Scan Qr

INRL-MD Deploy Methods

Deploy To Heroku

Deploy To Railway

Deploy To Koyeb

Deploy To Replit

Termux Guide

termux-setup-storage
apt update
apt upgrade
pkg update && pkg upgrade
pkg install python
pkg install python2
pkg install bash
pkg install libwebp
pkg install git -y
pkg install nodejs -y 
pkg install ffmpeg -y 
pkg install wget
pkg install imagemagick -y
git clone Your Forked Github Url
cd inrl-bot-md
npm i
npm start

Support

SUPPORT GROUP

EXTERNAL PLUGINS

Click Here

OpenMendel/OpenADMIXTURE.jl

2023-10-16T01:30:36Z

probcomp/Gen.jl

2023-10-17T01:32:42Z

A general-purpose probabilistic programming system with programmable inference

digitalinnovationone/dio-lab-open-source

2023-10-16T01:30:38Z

⚠LEIA A ISSUE FIXADA! Repositório do lab Contribuindo em um Projeto Open Source no GitHub da Digital Innovation One.

Contribuindo em um Projeto Open Source no GitHub

Repositório desenvolvido para fins didáticos, com a disponibilização de materiais de apoio para o lab Contribuindo em um Projeto Open Source no GitHub da Digital Innovation One.

Objetivo

Aprender o básico sobre contribuição no GitHub.

Ferramentas

Percurso

Nº	Etapas	Materiais de Apoio
01	Introdução ao Lab
02	Formas de Contribuir num Projeto Open Source
03	Desenvolvendo e Enviando uma Contribuição
04	Dicas e Materiais de Apoio

Desafio: Profile README

Contribua no diretório "Community", criando um Profile README contendo informações sobre você que deseje compartilhar com a comunidade. Para isso, você pode inserir: badges indicando suas habilidades; cards com suas estatísticas no GitHub e projetos que criou, colaborou ou que deseje que outras pessoas colaborem. Além disso, você pode inserir também links para seus desafios de projeto e artigos na plataforma da Digital Innovation One.
Inspire-se consultando os exemplos na pasta community, confira alguns utilitários na pasta utils e use sua criatividade para criar o seu 😊💙.

Instruções (PT/BR)

Faça um Fork deste repositório;
Clone localmente: git clone https://github.com/SEU_USERNAME/dio-lab-open-source.git;
Adicione o remote upstream para manter seu repositório local atualizado. Por exemplo: git remote add upstream https://github.com/digitalinnovationone/dio-lab-open-source.git;

Utilize o comando git pull upstream main para baixar e mesclar as alterações no seu repositório local com base na branch main deste repositório original de onde você fez o fork, ou git fetch upstream main para baixar sem mesclar. Veja mais em: Primeiros Passos com Git e GitHub.
Crie/Referêncie uma nova branch e nomeie como feat/community/SEU_USERNAME: git checkout -b feat/community/SEU_USERNAME;

Exemplo: git checkout -b feat/community/elidianaandrade
Dentro da pasta community, crie um arquivo em Markdown (extensão .md) e nomeie com o mesmo nome do seu usuário no GitHub;

Exemplo: elidianaandrade.md
Desenvolva o seu perfil. Para isso, você pode ver exemplos na pasta community e adicionar alguns dos utilitários presentes na pasta utils;

Observação: Use os outros exemplos como inspiração e não cópia.
Adicione suas alterações a "staging area" com o comando git add community/SEU_USERNAME.md;
Crie um commit e adicione a mensagem indicando a adição do seu perfil git commit -m"feat: add SEU_USERNAME profile";
Envie as alterações para o seu repositório remoto git push origin feat/community/SEU_USERNAME;
Crie um Pull Request.

Instructions (EN/US)

Fork this repository;
Clone locally: git clone https://github.com/YOUR_USERNAME/dio-lab-open-source.git;
Add the upstream remote to keep your local repository updated. For instance: git remote add upstream https://github.com/digitalinnovationone/dio-lab-open-source.git;

Use the command git pull upstream main to download and merge the changes in your local repository based on the main branch of this original repository from which you forked, or git fetch upstream main to download without merging. Learn more at: Getting Started with Git and GitHub.
Create/Reference a new branch and name it feat/community/YOUR_USERNAME: git checkout -b feat/community/YOUR_USERNAME;

Example: git checkout -b feat/community/elidianaandrade
Inside the community folder, create a Markdown file (extension .md) and name it after your GitHub username;

Example: elidianaandrade.md
Develop your profile: For that, you can see examples in the community folder and add some of the utilities available in the utils folder;

Note: Use the other examples as inspiration, not as a copy.
Add your changes to the "staging area" with the command git add community/YOUR_USERNAME.md;
Create a commit and add a message indicating the addition of your profile git commit -m"feat: add YOUR_USERNAME profile";
Push the changes to your remote repository git push origin feat/community/YOUR_USERNAME;
Create a Pull Request.

Instrucciones (ES/ES)

Haz un Fork de este repositorio;
Clona localmente: git clone https://github.com/TU_USERNAME/dio-lab-open-source.git;
Añade el remote upstream para mantener tu repositorio local actualizado. Por ejemplo: git remote add upstream https://github.com/digitalinnovationone/dio-lab-open-source.git;

Usa el comando git pull upstream main para descargar y fusionar los cambios en tu repositorio local basado en la rama main de este repositorio original del cual hiciste el fork, o git fetch upstream main para descargar sin fusionar. Aprende más en: Primeros Pasos con Git y GitHub.
Crea/Referencia una nueva branch y nómbrala feat/community/TU_USERNAME: git checkout -b feat/community/TU_USERNAME;

Ejemplo: git checkout -b feat/community/elidianaandrade
Dentro de la carpeta community, crea un archivo en Markdown (extensión .md) y nómbralo con el mismo nombre de tu usuario en GitHub;

Ejemplo: elidianaandrade.md
Desarrolla tu perfil. Para eso, puedes ver ejemplos en la carpeta community y añadir algunas de las utilidades presentes en la carpeta utils;

Nota: Usa los otros ejemplos como inspiración y no como copia.
Agrega tus cambios al "área de preparación" con el comando git add community/TU_USERNAME.md;
Crea un commit y añade un mensaje indicando la adición de tu perfil git commit -m"feat: add TU_USERNAME profile";
Envía los cambios a tu repositorio remoto git push origin feat/community/TU_USERNAME;
Crea un Pull Request.

Utilitários

Contribua

Este é um projeto feito para a comunidade, então sinta-se livre para contribuir. Algumas formas de contribuição além do seu exemplo de Profile README, é inserir outros utilitários na pasta utils, ou melhorar a página de pesquisa dos READMEs fazendo modificações nos arquivos da pasta docs.
Além disso, você também pode contribuir:

⚠️ Resolvendo, respondendo ou indicando issues

⭐ Adicionando aos favoritos (star)

Membros da comunidade que já contribuiram:

Feito com 💙 por Eli.

PWhiddy/PokemonRedExperiments

2023-10-16T01:30:38Z

Playing Pokemon Red with Reinforcement Learning

Train RL agents to play Pokemon Red!

Watch the Video on Youtube!

Running the Pretrained Model Interactively 🎮

🐍 Python 3.10 is recommended. Other versions may work but have not been tested.

Copy your legally obtained Pokemon Red ROM into the base directory. You can find this using google, it should be 1MB. Rename it to PokemonRed.gb if it is not already. The sha1 sum should be ea9bcae617fdf159b045185467ae58b2e4a48b9a, which you can verify by running shasum PokemonRed.gb.
Move into the baselines/ directory:
cd baselines
Install dependencies:
pip install -r requirements.txt
It may be necessary in some cases to separately install the SDL libraries.
Run:
python run_pretrained_interactive.py

By default the game with terminate after 32K steps, or ~1 hour. You can increase this by adjusting the ep_length variable, but it will also use more memory.

Interact with the emulator using the arrow keys and the a and s keys (A and B buttons).
You can pause the AI's input during the game by editing agent_enabled.txt

Note: the Pokemon.gb file MUST be in the main directory and your current directory MUST be the baselines/ directory in order for this to work.

Training the Model 🏋️

Note: By default this can use up to ~100G of RAM. You can decrease this by reducing the num_cpu or ep_length, but it may affect the results. Also, the model behavior may become degenerate for up to the first 50 training iterations or so before starting to improve. This could likely be fixed with better hyperparameters but I haven't had the time or resources to sweep these.

Previous steps 1-3
Run:
python run_baseline_parallel.py

Tracking Training Progress 📈

You can view the current state of each emulator, plot basic stats, and compare to previous runs using the VisualizeProgress.ipynb notebook.

Extra 🐜

Map visualization code can be found in visualization/ directory.

camenduru/LLaVA-colab

2023-10-16T01:30:38Z

Send your valuable codes here

Hactoberfest 2023

A beginner-friendly project to help you in open-source contribution. Made specifically for contribution in HACKTOBERFEST 2023! Hello World Programs and Algorithms! Please leave a star to support this project! ![](https://hacktoberfest.digitalocean.com/_nuxt/img/logo-hacktoberfest-full.f42e3b1.svg)

This All programs For beginner

Enjoy All Hacktoberfest has a simple and plain moto.

Beginner-Hacktoberfest

Need Your first pr for hacktoberfest 2k23 ? come on in

❓ What's Hacktoberfest 2023?

Hacktoberfest is the easiest way to get into open source! Hacktoberfest is a month long festival of open source code presented by Digital Ocean and DEV this year in 2023.

During the entire month of October 2022, all you have to do is contribute to any open source projects and open at least 4 pull requests. Yes, any project and any kind of contributions. It can be a be a bug fix, improvement, or even a documentation change! And win a T-Shirt and awesome stickers.

If you’ve never contributed to open source before, this is the perfect time to get started because Hacktoberfest provides a large list of available contribution opportunities (and yes, there are always plenty for beginners too).

👕 Why Should I Contribute?

Hacktoberfest has a simple and plain moto.

Support open source and earn a limited edition T-shirt!

So, yes! You can win a T-Shirt and few awesome stickers to attach on your laptop. On plus side, you will get into beautiful world of open source and get the international exposure.
Wait there's more!

👍 This is Awesome! How Can I Contribute?

It's very easy. You don't need to be an expert in coding and programming. Here are the steps you need to follow to create your -(maybe)- EXAMPLE first pull request within few minutes.

Star this repository.
Navigate To index.html or main.css do so crazy contribution file
Edit the file and insert the line of text in the specified location in the format as given in comment .
Now click on Propose button.
Create a new pull request.
Wait for your Pull Request to be reviewed and merged!
Enjoy and welcome to Hacktoberfest 2023 and Keep Contributing :)

You Can Upload Coded Projects In the Codes Directory

Code Of Conduct

Examples of behavior that contributes to creating a positive environment :

Using welcoming and inclusive language
Gracefully accepting constructive criticism
Focusing on what is best for the community
Being respectful of differing viewpoints and experiences

Examples of unacceptable behavior by participants include:

Trolling, insulting/derogatory comments, and personal or political attacks
Public or private harassment
Publishing others' private information, such as a physical or electronic address, without explicit permission

🎯Objectives

The Main Objectives of this Repositry is to help People for their Contribution in Hacktoberfest 2022

pleisto/flappy

2023-10-17T01:33:01Z

Production-Ready LLM Agent SDK for Every Developer

Flappy Monorepo

⚠ This project is still under development. We're working hard to release the first version of Flappy as soon as possible. Stay tuned! Documentation and code examples will be available soon.

This monorepo gathers all the Flappy libraries, each implemented in a different programming language. Flappy is a library developed to streamline the creation of AI applications and agents that use Large Language Models (LLMs).

Overview

Flappy is a production-ready Language Learning Model (LLM) Application/Agent SDK designed to simplify AI integration in your projects. It is an easy-to-use, universally compatible, and production-ready solution that brings the power of AI to developers regardless of their preferred programming language.

Key Features

Ease of Use: Flappy is designed to be as user-friendly as CRUD application development, minimizing the learning curve for developers new to AI.
Production-Ready: Beyond research, Flappy is a robust SDK that balances cost-efficiency and sandbox security to provide a stable platform for commercial environments.
Language-Agnostic: Flappy integrates seamlessly with any programming language, eliminating the need for Python unless explicitly required by your application.

Core Components

Agent Functions

In Flappy's ecosystem, an agent operates as a versatile conduit for the LLM, performing a variety of tasks such as structuring data, invoking external APIs, or sandboxing LLM-generated Python code as needed. This design philosophy caters to the increasing demand for LLM-based AI applications across various sectors.

The agent functions in Flappy are built on two foundational types:

InvokeFunction: This function allows agents to interact with the environment. It's defined by input and output parameters, facilitating efficient interaction with the LLM.
SynthesizedFunction: This function is processed by the LLM and only requires the definition of its description and the structure of its inputs and outputs.

Function Implementation Details

Flappy introduces unique implementation mechanisms to enhance these functions:

Unique JSON Schema Integration: Users can define abstract classes in their preferred programming language, which Flappy then transforms into JSON Schema schemas. This feature enhances machine readability and interoperability and manages the inputs and outputs of LLMs, providing controlled, consistent, and machine-readable data.
AST Parsing: Flappy performs Abstract Syntax Tree (AST) parsing on the LLM outputs to ensure that the generated JSON data strictly adheres to the defined JSON Schema schema.

Code Interpreter

Flappy's Code Interpreter serves as a secure environment to execute Python or TypeScript code produced by LLMs. It provides a sandboxed safety feature that reduces runtime errors and potential security vulnerabilities, making it suitable for deployment in a production environment.

LLM Abstraction Layer

To enhance the flexibility of application development, Flappy provides an abstraction layer for different LLMs. This feature allows users to easily switch between different LLMs and designate fallback LLMs, ensuring application stability.

Flappy empowers developers to build LLM-based applications in a language-agnostic way. Start your journey with Flappy today and harness the immense potential of AI in your preferred programming language.

Getting Started

To begin with Flappy, select your preferred language implementation from the list below:

Node.js
Kotlin&Java
Ruby (coming soon)
PHP (coming soon)
C#
Go (coming soon)
Python (coming soon)

Contributing

We're thrilled to receive contributions from the community! For more details, please refer to our contributing guidelines.

License

digama0/lean4lean

2023-10-16T01:31:07Z

Lean 4 kernel / 'external checker' written in Lean 4

montalvomiguelo/hydrogen-theme

2023-10-16T01:31:14Z

A port of Hydrogen's default template to Shopify OS 2.0

yzharko/spbspu-labs-2023-aap-master

2023-10-16T01:31:42Z

Лабораторные работы по дисциплине "Алгоритмизация и программирование" групп ПИ[1 | 5 | 6]

saty-a/FlutterHub

2023-10-17T01:33:57Z

FlutterHub: Your source for top Flutter projects! Explore apps, UI components, plugins, and more to fuel your Flutter development. Join the community today!. And give this repo a ⭐

skynet2982/toulouse.social-uptime

2023-10-17T01:33:54Z

Uptime page for toulouse.social

mgforehand/monitor

2023-10-17T01:33:54Z

Kumaresh0402/ComputationalThermalEngineering

2023-10-17T01:34:01Z

cruise-automation/mlir-tcp

2023-10-16T01:32:01Z

Tensor Compute Primitives (Mid-level Intermediate Representation for Machine Learning Programs)

auricom/nix-config

2023-10-16T01:32:33Z

danielctull-tests/BackgroundTaskTest

2023-10-16T01:32:48Z

IMA Plugin for Brightcove Player SDK for iOS

IMA Plugin for Brightcove Player SDK for iOS, version 6.12.5.2535

Installation

IMA Plugin for Brightcove Player SDK provides a dynamic library framework for installation.

The IMA plugin supports version 3.19.1 of the Google IMA SDK for iOS and version 4.9.1 of the Google IMA SDK for tvOS.

CocoaPods

You can use CocoaPods to add the IMA Plugin for Brightcove Player SDK to your project. You can find the latest Brightcove-Player-IMA podspec here. The pod will incorporate the correct version of IMA automatically.

CocoaPod Podfile example:

source 'https://github.com/CocoaPods/Specs'
source 'https://github.com/brightcove/BrightcoveSpecs.git'

platform :ios, '14.0'
use_frameworks!

target 'MyIMAPlayer' do
  pod 'Brightcove-Player-IMA'
end

As of IMA release 3.4.1, AdMob is published as a standalone dynamic framework and can no longer be installed as part of the IMA Plugin for the Brightcove Native Player SDK. As such, there is no longer a ForAdMob subspec for the podspec. To use AdMob, download it and add it to your project manually, or add the Google-Mobile-Ads-SDK CocoaPod to your Podfile:

pod 'Google-Mobile-Ads-SDK'

Manual

To add the IMA Plugin for Brightcove Player SDK to your project manually:

Download the Brightcove Player SDK framework.
Download the IMA Plugin for Brightcove Player SDK framework.
Download the Google IMA framework.
On the "General" tab of your application target, add the dynamic framework, BrightcovePlayerSDK.framework or BrightcovePlayerSDK.xcframework, from the Brightcove Player SDK download to the list of Frameworks, Libraries, and Embedded Content. The universal Framework and XCFramework are found in the ios/dynamic directory of the download. The Embed setting must be "Embed & Sign".
On the "General" tab of your application target, add BrightcoveIMA.framework or BrightcoveIMA.xcframework from the IMA Plugin for Brightcove Player SDK download to the list of Frameworks, Libraries, and Embedded Content. The Embed setting must be "Embed & Sign".
On the "General" tab of your application target, add GoogleInteractiveMediaAds.xcframework from the Google IMA download to the list of Frameworks, Libraries, and Embedded Content. The Embed setting for the XCFrameworks must be "Embed & Sign".
On the "Build Settings" tab of your application target, ensure that the "Framework Search Paths" include the paths to the frameworks. This should have been done automatically unless the framework is stored under a different root directory than your project.
On the "Build Settings" tab of your application target:
- Ensure that -ObjC has been added to the "Other Linker Flags" build setting.
(Universal Framework only) On the "Build Phases" tab, add a "Run Script" phase with the command bash ${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/BrightcoveIMA.framework/strip-frameworks.sh. Check "Run script only when installing". This will remove unneeded architectures from the build, which is important for App Store submission.
(Apple Silicon only) On the "Build Settings" tab of your application target:
- Ensure that arm64 has been added to your "Excluded Architectures" build setting for Any iOS Simulator SDK.

Swift Package Manager

To add the IMA Plugin for Brightcove Player SDK to your project with Swift Package Manager:

First follow the steps to add the Core XCFramework with Swift Package Mananger.
Add the IMA package to Swift Package Manager using https://github.com/brightcove/brightcove-player-sdk-ios-ima.git.
Download the Google IMA framework.
On the "General" tab of your application target, add GoogleInteractiveMediaAds.xcframework to the list of Frameworks, Libraries, and Embedded Content. The Embed setting for the XCFrameworks must be "Embed & Sign".
On the "Build Settings" tab of your application target, ensure that the "Framework Search Paths" include the paths to the frameworks. This should have been done automatically unless the framework is stored under a different root directory than your project.

Imports

The IMA Plugin for Brightcove Player SDK can be imported into code a few different ways; @import BrightcoveIMA;, #import <BrightcoveIMA/BrightcoveIMA.h> or #import <BrightcoveIMA/[specific class].h>. You can import the GoogleInteractiveMediaAds and BrightcovePlayerSDK modules in similar fashion.

Quick Start

The BrightcoveIMA plugin is a bridge between Google IMA iOS SDK v3 and the Brightcove Player SDK for iOS. This snippet shows its basic usage with VMAP ad rules.

[1] IMASettings *imaSettings = [[IMASettings alloc] init];
    imaSettings.ppid = kViewControllerIMAPublisherID;
    imaSettings.language = kViewControllerIMALanguage;

    IMAAdsRenderingSettings *renderSettings = [[IMAAdsRenderingSettings alloc] init];
    renderSettings.webOpenerPresentingController = self;

    UIView *videoContainerView = <UIView of video container>;
    NSString *adTag = <ad tag>;

[2] BCOVIMAAdsRequestPolicy *adsRequestPolicy = [BCOVIMAAdsRequestPolicy adsRequestPolicyWithVMAPAdTagUrl:adTag];

    BCOVPlayerSDKManager *manager = [BCOVPlayerSDKManager sharedManager];
    id<BCOVPlaybackController> controller =
[3]         [manager createIMAPlaybackControllerWithSettings:imaSettings
                                        adsRenderingSettings:renderSettings
                                            adsRequestPolicy:adsRequestPolicy
                                                 adContainer:videoContainerView 
                                              viewController:self
                                              companionSlots:nil
                                                viewStrategy:nil];
    controller.delegate = self;

    [videoContainerView addSubview:controller.view];  

    NSString *policyKey = <your-policy-key>;
    NSString *accountId = <your-account-id>;
    NSString *videoID = <your-video-id>;
    BCOVPlaybackService *playbackService = [[BCOVPlaybackService alloc] initWithAccountId:accountID
                                                                                policyKey:policyKey];
    NSDictionary *configuration = @{
        kBCOVPlaybackServiceConfigurationKeyVideoID:videoID
    };
    [playbackService findVideoWithConfiguration:configuration
                                queryParameters:nil
                                     completion:^(BCOVVideo    *video,
                                                  NSDictionary *jsonResponse,
                                                  NSError      *error) {

              [controller setVideos:@[ video ]];
              [controller play];

    }];

Breaking the code down into steps:

Create the same IMA settings, ads rendering settings that you would create if you were using Google's IMA iOS SDK directly. These are required.
BCOVIMAAdsRequestPolicy provides methods to specify VAST or VMAP ad rules. Select the appropriate method to select your ads policy.
BrightcoveIMA adds some category methods to BCOVPlaybackManager. The first of these is -createIMAPlaybackControllerWithSettings:adsRenderingSettings:adsRequestPolicy:adContainer:companionSlots:viewStrategy:. Use this method to create your playback controller.

Play and Pause

The Brightcove IMA Plugin implements custom play and pause logic to ensure the smoothest possible ad experience. Therefore, you will need to make sure that you use the play method on the BCOVPlaybackController or the -[BCOVSessionProviderExtension ima_play] or -[BCOVSessionProviderExtension ima_pause] (BCOVSessionProviderExtension), and not the AVPlayer.

As an example, calling play for the first time on BCOVPlaybackController allows BCOVIMA to process preroll ads without any of the content playing before the preroll. For more information on how BCOVIMA overrides the default BCOVPlaybackController methods, please check out BCOVSessionProviderExtension.

Using the Built-In PlayerUI

In your UIViewController, create a BCOVPUIPlayerView property called the player view, to contain the playback controls, the video content view, and a special view where IMA can display its ads.

// PlayerUI's player view
@property (nonatomic) BCOVPUIPlayerView *playerView;

Then create your player view; supply a nil playback controller which will be added later. This player view contains both the video content view and the view that displays playback controls and ad controls. This setup is the same no matter what plugin you are using. Set up the player view to match the video container from your layout (videoView) when it resizes.

// Create and configure Control View.
BCOVPUIBasicControlView *controlView = [BCOVPUIBasicControlView basicControlViewWithVODLayout];
    
// Create the player view with a nil playback controller.
self.playerView = [[BCOVPUIPlayerView alloc] initWithPlaybackController:nil options:nil controlsView:controlView];
// Add BCOVPUIPlayerView to your video view.
[self.videoView addSubview:self.playerView];

You'll need to set up the layout for the player view, you can do this with Auto Layout or the older Springs & Struts method.

Springs & Struts

self.playerView.frame = self.videoView.bounds;
self.playerView.autoresizingMask = UIViewAutoresizingFlexibleHeight | UIViewAutoresizingFlexibleWidth;

Auto Layout

self.playerView.translatesAutoresizingMaskIntoConstraints = NO;
[NSLayoutConstraint activateConstraints:@[
                                          [self.playerView.topAnchor constraintEqualToAnchor:self.videoView.topAnchor],
                                          [self.playerView.rightAnchor constraintEqualToAnchor:self.videoView.rightAnchor],
                                          [self.playerView.leftAnchor constraintEqualToAnchor:self.videoView.leftAnchor],
                                          [self.playerView.bottomAnchor constraintEqualToAnchor:self.videoView.bottomAnchor],
                                         ]];

Creating the playback controller is specific to IMA. Create your playback controller as you did above, but instead of your video container view, pass in the contentOverlayView from the player view as your adContainer. The contentOverlayView is a special view used for overlaying views on the main video content.

// Create the playback controller.
id<BCOVPlaybackController> controller =
                [manager createIMAPlaybackControllerWithSettings:imaSettings
                                            adsRenderingSettings:renderSettings
                                                adsRequestPolicy:adsRequestPolicy
                                                     adContainer:self.playerView.contentOverlayView // special view for IMA ad content
                                                  viewController:self
                                                  companionSlots:nil
                                                    viewStrategy:nil];
controller.delegate = self;

// Assign new playback controller to the player view.
// This associates the playerController's session with the PlayerUI.
// You can keep this player view around and assign new
// playback controllers to it as they are created.
self.playerView.playbackController = self.playbackController;

Now, when playing video with ads, you will see the PlayerUI controls while playing video content, plus ad markers on the timeline scrubber (VMAP ads only).

The PlayerUI is highly customizable. For more information and sample code, please see Custom Layouts section in the README.md file of the Brightcove Native Player SDK repository.

Seek Without Ads

Use -[BCOVPlaybackController seekWithoutAds:(CMTime)seekToTime completionHandler:(void (^)(BOOL finished))completion] to resume playback at a specific time without forcing the user to watch ads scheduled before seekToTime.

In preparation for seekWithoutAds:completionHandler:, disable autoPlay when setting up the BCOVPlaybackController.

Apple recommends waiting for the status of an AVPlayerItem to change to ready-to-play before using the AVPlayerItem. Therefore, call seekWithoutAds:completionHandler: in the kBCOVPlaybackSessionLifecycleEventReady handler of the playbackController:playbackSession:didReceiveLifecycleEvent method of your BCOVPlaybackControllerDelegate.

- (void)playbackController:(NSObject<BCOVPlaybackController>*)controller
           playbackSession:(NSObject<BCOVPlaybackSession>*)session
  didReceiveLifecycleEvent:(BCOVPlaybackSessionLifecycleEvent *)lifecycleEvent
{
  if ([kBCOVPlaybackSessionLifecycleEventReady isEqualToString:lifecycleEvent.eventType])
  {
    // self.resumePlayback is a hypothetical instance variable used here for illustration.
    if (self.resumePlayback)
    {
      __weak typeof(controller) weakController = controller;

      // seek without playing ads which are scheduled before the seek time, i.e. resume playback.
      [controller seekWithoutAds:CMTimeMake(seekWithoutAdsValue, seekWithoutAdsTimescale)
               completionHandler:^(BOOL finished) {

        if (!finished)
        {
          NSLog (@"seekWithoutAds failed to finish");
        }

        typeof(controller) strongController = weakController;
        if (strongController)
        {
          // fade out the shutter to reveal the player view.
          strongController.shutterFadeTime = 0.25;
          strongController.shutter = NO;

          // turn off seek without ads - especially important if this player is being used with a playlist
          self.resumePlayback = NO;
        }

      }];
    }
  }
}

The shutter and shutterFadeTime properties of the BCOVPlaybackController can be used along with seekWithoutAds:completionHandler: to hide frame-flicker which can occur as the AVPlayer loads assets. In your BCOVPlaybackController set-up code, enable the shutter to hide the player view:

  NSObject<BCOVPlaybackController> *playbackController;
        
  playbackController = [sdkManager createFWPlaybackControllerWithAdContextPolicy:nil
                                                                    viewStrategy:nil];
  playbackController.delegate = self;

  if (self.resumePlayback)
  {
    // set the shutter fade time to zero to hide the player view immediately.
    playbackController.shutterFadeTime = 0.0;
    playbackController.shutter = YES;
    
    // disable autoPlay when resuming playback.
    playbackController.autoPlay = NO;
  }

Note that when Seek Without Ads is used in your app, you might observe network traffic which normally occurs as part of setting up the IMA plugin. This traffic is necessary for proper plugin setup, and does not affect the Seek Without Ads functionality.

Customizing Plugin Behavior

There are a couple of configuration points in BCOVIMA. You can combine BCOVIMA with another plugin for the Brightcove Player SDK for iOS, you can create a custom view strategy, and you can supply a custom ads request policy.

VAST and VMAP ad rules

BCOVIMA gives you control over how ads requests are made, via the BCOVIMAAdsRequestPolicy class. The class provides factory methods for the supported policies. Once you obtain an instance of the correct policy, you need to provide it to the BCOVPlayerSDKManager to create a playback controller or a playback session provider.

In Quick Start, an example of VMAP is given. Here is a VAST example.

    IMASettings *imaSettings = [[IMASettings alloc] init];
    imaSettings.ppid = kViewControllerIMAPublisherID;
    imaSettings.language = kViewControllerIMALanguage;

    IMAAdsRenderingSettings *renderSettings = [[IMAAdsRenderingSettings alloc] init];
    renderSettings.webOpenerPresentingController = self;

    UIView *videoContainerView = <UIView of video container>;

[1] BCOVIMAAdsRequestPolicy *adsRequestPolicy = [BCOVIMAAdsRequestPolicy adsRequestPolicyWithVASTAdTagsInCuePointsAndAdsCuePointProgressPolicy:nil];

    BCOVPlayerSDKManager *manager = [BCOVPlayerSDKManager sharedManager];
    id<BCOVPlaybackController> controller =
            [manager createIMAPlaybackControllerWithSettings:imaSettings
                                        adsRenderingSettings:renderSettings
                                            adsRequestPolicy:adsRequestPolicy
                                                 adContainer:videoContainerView
                                              viewController:self
                                              companionSlots:nil
                                                viewStrategy:nil];

Let's break this code down into steps, to make it a bit simpler to digest:

This example is the same as the one provided in the quick-start, except that we are now calling a different BCOVIMAAdsRequestPolicy policy method to specify that we want to use VAST.

BCOVIMAAdsRequestPolicy has four factory methods to generate ads request policy; two for VMAP and two for VAST. Two factory methods for VMAP are described in more detail below:

+videoPropertiesVMAPAdTagUrlAdsRequestPolicy: This method returns the default ads request policy, which looks for the kBCOVIMAAdTag in each BCOVVideo's properties to determine the VMAP ad tag that should be used to request ads.
+adsRequestPolicyWithVMAPAdTagUrl:: This method returns an ads request policy that always uses the same ad tag for every video. If you use this policy, you do not have to put the ad tag in the BCOVVideos' properties. This is the easiest way to specify an ad tag if you know your ad tag will never change for the lifetime of the application session.

There are two factory methods for VAST. All of the VAST methods take a BCOVCuePointProgressPolicy. The cue point policy determines which BCOVCuePoints will get processed by the BCOVIMAAdsRequestPolicy. The VAST policies are as follows:

+adsRequestPolicyWithVASTAdTagsInCuePointsAndAdsCuePointProgressPolicy: This method returns an ads request policy that checks each BCOVVideo for BCOVCuePoints of type 'kBCOVIMACuePointTypeAd' and looks in each of those cue points properties for the key kBCOVIMAAdTag to determine the VAST ad tag that should be used to request ads.
+adsRequestPolicyFromCuePointPropertiesWithAdTag:adsCuePointProgressPolicy: This method returns an ad request policy that uses the specified VAST ad tag for all BCOVCuePoints of type kBCOVIMACuePointTypeAd. Properties of the cue point are appended to the ad tag as query parameters.

You can add VAST ad tag cuepoints to a video by using the update: method on the BCOVVideo object. The following example adds pre-roll, mid-roll and post-roll cuepoints:

// Objective-C
- (BCOVVideo *)updateVideo:(BCOVVideo *)video
{
    // Determine mid-point of video so we can insert a cue point there
    CGFloat durationMiliSeconds = ((NSNumber *)video.properties[@"duration"]).doubleValue;
    CGFloat midpointSeconds = (durationMiliSeconds / 2) / 1000;
    CMTime midpointTime = CMTimeMakeWithSeconds(midpointSeconds, 1);

    return [video update:^(id<BCOVMutableVideo> mutableVideo)
    {
        mutableVideo.cuePoints = [[BCOVCuePointCollection alloc] initWithArray:@[
            [[BCOVCuePoint alloc] initWithType:kBCOVIMACuePointTypeAd
                                      position:kCMTimeZero
                                    properties:@{ kBCOVIMAAdTag : kVASTAdTagURL }],
            [[BCOVCuePoint alloc] initWithType:kBCOVIMACuePointTypeAd
                                      position:midpointTime
                                    properties:@{ kBCOVIMAAdTag : kVASTAdTagURL }],
            [[BCOVCuePoint alloc] initWithType:kBCOVIMACuePointTypeAd
                                      position:kBCOVCuePointPositionTypeAfter
                                    properties:@{ kBCOVIMAAdTag : kVASTAdTagURL }]

        ]];
        
    }];
}

// Swift
func updateVideo(withVASTTag vastTag: String) -> BCOVVideo? {
    
    guard let durationNum = self.properties["duration"] as? NSNumber else {
        return nil
    }
    
    let durationMiliSeconds = durationNum.doubleValue
    let midpointSeconds = (durationMiliSeconds / 2) / 1000
    let midpointTime = CMTimeMakeWithSeconds(midpointSeconds, preferredTimescale: 1)
    
    let cuePointPositionTypeAfter = CMTime.positiveInfinity
    
    return update { (mutableVideo: BCOVMutableVideo?) in
        guard let mutableVideo = mutableVideo else {
            return
        }
        
        mutableVideo.cuePoints = BCOVCuePointCollection(array: [
            BCOVCuePoint(type: kBCOVIMACuePointTypeAd, position: CMTime.zero, properties: [kBCOVIMAAdTag:vastTag])!,
            BCOVCuePoint(type: kBCOVIMACuePointTypeAd, position: midpointTime, properties: [kBCOVIMAAdTag:vastTag])!,
            BCOVCuePoint(type: kBCOVIMACuePointTypeAd, position: cuePointPositionTypeAfter, properties: [kBCOVIMAAdTag:vastTag])!,
        ])
    }
    
}

You can also convert cuepoints created in VideoCloud to VAST cuepoints like this:

- (BCOVVideo *)updateVideo:(BCOVVideo *)video
    NSArray *cuePoints = video.cuePoints.array;
    NSMutableArray *updatedCuePoints = @[].mutableCopy;
    for (BCOVCuePoint *cuePoint in cuePoints)
    {
        if ([cuePoint.type isEqualToString:kBCOVIMACuePointTypeAd])
        {
            // The "metadata" property is the value of the
            // "Key/Value Pairs" field in VideoCloud when
            // creating/editing a Cue Point. In this example
            // the only value in this field is the VAST ad tag URL.
            // If you have additional values you'll need to parse
            // out just the ad tag URL.
            NSString *metadata = cuePoint.properties[@"metadata"];
            NSDictionary *properties = @{ kBCOVIMAAdTag : metadata };
            BCOVCuePoint *updatedCuePoint = [[BCOVCuePoint alloc] initWithType:cuePoint.type position:cuePoint.position properties:properties];
            [updatedCuePoints addObject:updatedCuePoint];
        }
    }
    return [video update:^(id<BCOVMutableVideo> mutableVideo) {
        mutableVideo.cuePoints = [BCOVCuePointCollection collectionWithArray:updatedCuePoints];
    }];
}

Modifying the IMAAdsRequest

The IMA Plugin passes an IMAAdsRequest object to a BCOMIMAPlaybackSessionDelegate immediately before calling IMAAdsLoader -requestAdsWithAdsRequest, allowing the user to first modify the ads request. To receive the ads request callback, create an object that implements the BCOVIMAPlaybackSessionDelegate protocol.

@import BrightcovePlayerSDK;
@import BrightcoveIMA;

@interface MyViewController : UIViewController <BCOVIMAPlaybackSessionDelegate>

Create a BCOVIMASessionProvider using either createIMAPlaybackControllerWithSettings or createIMASessionProviderWithSettings, and provide an NSDictionary of options with an entry having a key of kBCOVIMAOptionIMAPlaybackSessionDelegateKey and a value which is your delegate.

NSDictionary *imaSessionProviderOptions = @{ kBCOVIMAOptionIMAPlaybackSessionDelegateKey: self };

id<BCOVPlaybackSessionProvider> imaSessionProvider =
    [sdkManager createIMASessionProviderWithSettings:imaSettings
                                adsRenderingSettings:renderSettings
                                    adsRequestPolicy:adsRequestPolicy
                                         adContainer:self.playerView.contentOverlayView
                                      viewController:self
                                      companionSlots:ni
                             upstreamSessionProvider:nil
                                             options:imaSessionProviderOptions];

Implement willCallIMAAdsLoaderRequestAdsWithRequest:forPosition: in your BCOVIMAPlaybackSessionDelegate.

- (void)willCallIMAAdsLoaderRequestAdsWithRequest:(IMAAdsRequest *)adsRequest
                                      forPosition:(NSTimeInterval)position
{
    adsRequest.vastLoadTimeout = 3000.;
}

View Strategy

You can provide a custom view strategy to the BCOVPlaybackManager when you are constructing your playback controller or session provider, rather than specify the defaultControlsViewStrategy directly. With a custom view strategy, the ad container view and ad companion slots can be tied with the video content view. This is an example of custom view strategy.

BCOVPlaybackControllerViewStrategy customViewStrategy = ^UIView* (UIView *view, id<BCOVPlaybackController> playbackController){
    
    BCOVPlaybackControllerViewStrategy defaultControlsViewStrategy = [playbackManager defaultControlsViewStrategy];
    UIView *contentAndDefaultControlsView = defaultControlsViewStrategy(view, playbackController);
    
    [<UIView of video container> addSubview:contentAndDefaultControlsView];
    
    return <UIView of video container>;
};

Composing Session Providers

If you are using more than one plugin to the Brightcove Player SDK for iOS that needs to create a customized playback controller, you must instead compose a chain of session providers and pass the final session provider to the -[BCOVPlayerSDKManager createPlaybackControllerWithSessionProvider:viewStrategy:] method.

When composing session providers, the session preloading can be enabled from BCOVBasicSessionProvider; however, preloading sessions with IMA plugin is strongly discouraged due to a bug in the Google IMA SDK when having multiple AVPlayers in memory.

Registering Ad Overlays

If you are placing any views over ads while they are playing, it is necceessary to register those views with the IMA SDK. Read the Friendly obstructions section of the Open Measurement in the IMA SDK page for more information.

You can get the current IMAAdDisplayContainer object neccessary to register your overlays from the playbackController:playbackSession:didEnterAdSequence: delegate method of your BCOVPlaybackController instance. For example:

- (void)playbackController:(id<BCOVPlaybackController>)controller playbackSession:(id<BCOVPlaybackSession>)session didEnterAdSequence:(BCOVAdSequence *)adSequence
{
    NSDictionary *props = session.video.properties;
    IMAAdDisplayContainer *adDisplayContainer = props[kBCOVIMAVideoPropertiesKeyAdDisplayContainer];
    [adDisplayContainer registerFriendlyObstruction:self.adOverlayView];
}

To unregister the obstructions when the ad sequence is finished, the playbackController:playbackSession:didExitAdSequence: delegate method of your BCOVPlaybackController instance can be used. For example:

- (void)playbackController:(id<BCOVPlaybackController>)controller playbackSession:(id<BCOVPlaybackSession>)session didExitAdSequence:(BCOVAdSequence *)adSequence
{
    NSDictionary *props = session.video.properties;
    IMAAdDisplayContainer *adDisplayContainer = props[kBCOVIMAVideoPropertiesKeyAdDisplayContainer];
    [adDisplayContainer unregisterAllFriendlyObstructions];
}

AirPlay

Brightcove does not offer support for using AirPlay with the IMA plugin. Google’s IMA SDK does not fully support AirPlay, and the usage of AirPlay with the IMA plugin is not recommended at this time. There are likely to be unexpected behaviors and bugs for which no solution exists.

However, if you wish to use this functionality in your apps set enableBackgroundPlayback to YES on IMASettings along with enabling AirPlay on your BCOVPlaybackController. See the "AirPlay" section of the Core SDK README for more information.

Picture-in-Picture

The Brightcove IMA plugin can be used with Brightcove's Picture-in-Picture support.

Ads can not be started if Picture-in-Picture is active, however if an ad is playing when Picture-in-Picture begins it will continue playing in the Picture-in-Picture window. Any VAST cue-points encountered after Picture-in-Picture has become active will be skipped. This is a limitation with the Google IMA SDK, see IMA SDK for iOS > Picture-in-picture for more information.

Supported configurations are:

VAST with pre, mid and/or post-rolls.
VMAP with a pre-roll.

Set enableBackgroundPlayback to YES on IMASettings and see the "Picture in Picture" section of the Core SDK README for more information.

If you are using a VAST configuration you will need to use this BCOVCuePointProgressPolicy:

BCOVCuePointProgressPolicy *policy = [BCOVCuePointProgressPolicy progressPolicyProcessingCuePoints:BCOVProgressPolicyProcessFinalCuePoint resumingPlaybackFrom:BCOVProgressPolicyResumeFromLastProcessedCuePoint ignoringPreviouslyProcessedCuePoints:YES];

Audience Segment Targeting

If you'd like to use Audience Segment Targeting with your IMA VAST ad requests you can do so by using the updateAudienceSegmentTargetingValues on BCOVPlaybackController. For eample:

[playbackController updateAudienceSegmentTargetingValues:@{
    @"account_id":@"11223344",
    @"account_type":@"premium""
}];

These values will be appended to the cust_params query paramater of the IMA ad request URL. For example:

The URL http://pubads.g.doubleclick.net/gampad/ads would become http://pubads.g.doubleclick.net/gampad/ads?cust_params=account_id%3D11223344%26account_type%3Dpremium.

AVPlayerViewController Support

Displaying Ad UI

If you'd like to display your own Ad UI during ad playback you can use the playbackController:playbackSession:didReceiveLifecycleEvent: delegate method. Here is an example:

#pragma mark BCOVPlaybackControllerDelegate

- (void)playbackController:(id<BCOVPlaybackController>)controller playbackSession:(id<BCOVPlaybackSession>)session didReceiveLifecycleEvent:(BCOVPlaybackSessionLifecycleEvent *)lifecycleEvent
{
    ...
    
    if ([lifecycleEvent.eventType isEqualToString:kBCOVIMALifecycleEventAdsManagerDidReceiveAdEvent])
    {
        IMAAdEvent *adEvent = lifecycleEvent.properties[@"adEvent"];
    }
    
    switch (adEvent.type)
    {
        case kIMAAdEvent_STARTED:
            [self displayAdUI:adEvent.ad.duration];
            break;
        case kIMAAdEvent_COMPLETE:
            [self hideAdUI];
            break;
        default:
            break;
    }
}

Frequently Asked Questions

I can hear the ads, but I can't see them playing.

This usually happens when the ad container view is not in the view hierarchy, or when the ad view (which is a subview of the ad container view) is covered by other views.

Support

If you have questions, need help or want to provide feedback, please use the Support Portal or contact your Account Manager. To receive notification of new SDK software releases, subscribe to the Brightcove Native Player SDKs Google Group.

pinterest/PINCache

2023-10-17T01:35:19Z

Fast, non-deadlocking parallel object cache for iOS, tvOS and OS X

PINCache

Fast, non-deadlocking parallel object cache for iOS and OS X.

PINCache is a fork of TMCache re-architected to fix issues with deadlocking caused by heavy use. It is a key/value store designed for persisting temporary objects that are expensive to reproduce, such as downloaded data or the results of slow processing. It is comprised of two self-similar stores, one in memory (PINMemoryCache) and one on disk (PINDiskCache), all backed by GCD and safe to access from multiple threads simultaneously. On iOS, PINMemoryCache will clear itself when the app receives a memory warning or goes into the background. Objects stored in PINDiskCache remain until you trim the cache yourself, either manually or by setting a byte or age limit.

PINCache and PINDiskCache accept any object conforming to NSCoding. Put things in like this:

Objective-C

UIImage *img = [[UIImage alloc] initWithData:data scale:[[UIScreen mainScreen] scale]];
[[PINCache sharedCache] setObject:img forKey:@"image" block:nil]; // returns immediately

Swift

let img = UIImage(data: data, scale:UIScreen.main.scale)
PINCache.shared().setObject(img, forKey: "img")

Get them back out like this:

Objective-C

[[PINCache sharedCache] objectForKeyAsync:@"image" block:^(PINCache *cache, NSString *key, id object) {
    UIImage *image = (UIImage *)object;
    NSLog(@"image scale: %f", image.scale);
}];

Swift

PINCache.shared().object(forKey: "image") { (cache, key, object) in
    if let image = object as? UIImage {
        print("image scale: %f", image.scale)
    }
}

Both PINMemoryCache and PINDiskCache use locks to protect reads and writes. PINCache coordinates them so that objects added to memory are available immediately to other threads while being written to disk safely in the background. Both caches are public properties of PINCache, so it's easy to manipulate one or the other separately if necessary.

Collections work too. Thanks to the magic of NSKeyedArchiver, objects repeated in a collection only occupy the space of one on disk:

Objective-C

NSArray *images = @[ image, image, image ];
[[PINCache sharedCache] setObject:images forKey:@"images"];
NSLog(@"3 for the price of 1: %d", [[[PINCache sharedCache] diskCache] byteCount]);

Swift

// In Swift, Array, String, and Dictionary are all value types.
let images = [image, image, image] as NSArray // Cast to NSArray
PINCache.shared.setObject(images, forKey: "images")
print("3 for the prices of 1: %d", PINCache.shared.diskCache.byteCount)

Installation

Manually

Download the latest tag and drag the PINCache folder into your Xcode project.

Install the docs by double clicking the .docset file under docs/, or view them online at cocoadocs.org

Git Submodule

git submodule add https://github.com/pinterest/PINCache.git
git submodule update --init

CocoaPods

Add PINCache to your Podfile and run pod install.

Carthage

Add the following line to your Cartfile and run carthage update --platform ios. Then follow this instruction of Carthage to embed the framework.

github "pinterest/PINCache"

Requirements

PINCache requires iOS 8.0, tvOS 9.0, watchOS 2.0 or macOS 10.8 and greater.

Contact

Garrett Moon

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

danieleteti/delphi-dmvcframework-htmx-todo

2023-10-17T01:36:03Z

DelphiMVCFramework Todo Sample, using HTMX

dalijap/nx-chronos

2023-10-17T01:36:03Z

NX Chronos - Chronometer for Delphi

Gilwyad/mailnesia.com

2023-10-16T01:33:25Z

Anonymous Email in Seconds

mailnesia.com - Anonymous Email in Seconds

Mailnesia is a fully featured disposable email provider. Just like a real email service but without any password or the ability to send mail. Features at a glance:

Automatically visits registration/activation links in emails, completing any registration process instantly
Alternate mailbox names (aliases) for extra anonymity, use any name you want
Alternative domain names (all mail is accepted regardless of domain name)
Displaying HTML emails correctly including attached images, files
Multiple encodings supported: Chinese, Japanese, Korean, Russian etc
RSS feed for every mailbox
New emails appear as they arrive, without needing to refresh the page
Fast, easy to use interface
Translated to 10+ languages

This repository contains the source code of Mailnesia. What it includes:

The website including everything: images, CSS, JavaScript etc
The email receiving server
Additional utilities for maintenance, testing etc
How to set up the SQL tables

What is not included:

Configuration for web server, database server or any other external utility
Scripts to start and monitor the website/RSS/email server processes

Architecture overview

Mailnesia is made with the perl programming language. It runs on Debian GNU/Linux. Nginx is used as web server, PostgreSQL as database server. Redis in-memory key storage server is used to store banned email addresses and IP's and other settings.

Custom SMTP server implemented in perl using AnyEvent::SMTP. Event based, using only one thread.
Website implemented using Mojolicious, powered by Nginx web server.
Emails are stored in a PostgreSQL database
Hosted on a virtual private server with SSD storage

The email server sends all received emails to several URL clicker processes using ZeroMQ to offload the email body processing which is somewhat CPU intensive.

Requirements and installation

Required Perl modules with versions are listed in the file 'cpanfile'.

Installation

Some modules might require compilation of C source code; these packages will take care of that on Debian 9 (Stretch):

apt-get install autotools-dev g++ gcc dpkg-dev cpp fakeroot gdbserver libalgorithm-merge-perl libalgorithm-diff-xs-perl libalgorithm-diff-perl libdpkg-perl libltdl-dev libltdl7 libpython2.6 python2.6 libreadline6 libsqlite3-0 m4 make manpages-dev patch python2.6-minimal g++-4.4 libstdc++6-4.4-dev gcc-4.4 binutils cpp-4.4 libc6-dev libc-dev-bin libmpfr4 libgmp3c2 libgomp1 linux-libc-dev

On Debian 11 (Bullseye):

apt-get update && apt-get install libzmq5 openssl libssl-dev zlib1g-dev autotools-dev g++ gcc dpkg-dev libdpkg-perl libltdl-dev libltdl7 libsqlite3-0 m4 make patch gcc-10 binutils cpp-10 libc6-dev libc-dev-bin libgomp1 linux-libc-dev libreadline8 cpanminus libpq-dev

The required Perl modules can be installed with the cpanm script. Install all requirements into a directory, for example ~/perl5:

cpanm --installdeps /directory/where/you/cloned/mailnesia.com/ --local-lib-contained ~/perl5/ --skip-satisfied

The path lib/perl5 under this chosen directory must be exported and used by each application, so they load their dependencies from it:

export PERL5LIB=~/perl5/lib/perl5

Setting up Redis

In /etc/redis/redis.conf:

Port 0
unixsocket /var/run/redis/redis.sock
unixsocketperm 777

Setting up PostgreSQL

Using password-less "trust" authentication for mailnesia PSQL user

This applies only if clients connect locally on UNIX sockets. In pg_hba.conf, after "Put your actual configuration here" but before the local and host configurations:

# TYPE  DATABASE    USER        CIDR-ADDRESS          METHOD
local   mailnesia   mailnesia                         trust

Create mailnesia user / database

as root:

su postgres
cd
createuser --superuser mailnesia

createdb mailnesia
as any user:

psql -U mailnesia

Create tables

Execute tools/psql-create-tables.sh to create all necessary tables and relations. The script also contains some documentation.

Translation

The script tools/translation.py is used to download the Google spreadsheet containing the translations.

How to contribute to a project without knowing a damn bit about it

https://domm.plix.at/perl/2013_09_open_source_plus_plus_contribute_without_knowing.html

Compressing CSS and JavaScript

Minifying is done with yui-compressor. This code snippet will automatically compress .js and .css files in the project directory upon save in Emacs.

(add-hook
 'after-save-hook
 (lambda ()
   (dolist (element '(
                      "/directory/containing/project/mailnesia.com/website/js/javascript.js"
                      "/directory/containing/project/mailnesia.com/website/css/style.css"
                      ))
     (when
         (string= buffer-file-name element)
       (save-window-excursion
         (shell-command (concat "yui-compressor -o " (replace-regexp-in-string "\\.\\([a-z]\\{2,3\\}\\)$" "-min.\\1" element ) " " element " &>/dev/null &"))
         )
       )
     )
   )
 )

Testing

Test running website and mail server by sending test emails: tools/test-mailnesia.pl

Execute function tests under t/ (these don't require the website to be up): prove

Mohammedcha/RE-SKINNING-CPA-Movie-Streaming-and-Download-Landing-Page-TMDB-API

2023-10-16T01:33:28Z

RE-SKINNING CPA Movie Streaming and Download Landing Page - TMDB API

RE-SKINNING CPA Movie Landing Page - TMDB API

Introducing the ultimate solution for captivating movie landing pages tailored for CPA marketing: the meticulously crafted Re-Skinning CPA Movie Landing Page. This dynamic web application, expertly engineered with a seamless fusion of HTML, PHP, JS, and CSS, boasts a powerful integration with the TMDB API, empowering users to effortlessly source and display an extensive array of movies automatically.

Developed by the esteemed Mohammed Cha & Re-Skinning Group, this movie landing page is the epitome of efficiency and elegance, purposefully designed to enthrall audiences and drive optimal conversions. By harnessing the cutting-edge capabilities of the TMDB API, users can enjoy an expansive repository of films, effortlessly curated and presented within the interface, all at absolutely no cost.

With its intuitive design and user-friendly interface, the Re-Skinning CPA Movie Landing Page offers a seamless browsing experience, ensuring visitors can explore an extensive selection of movies with unprecedented ease. Whether it's the latest blockbusters or timeless classics, this platform guarantees a diverse range of cinematic options to cater to every taste and preference.

Empower your CPA marketing endeavors with the unparalleled convenience and sophistication of the Re-Skinning CPA Movie Landing Page, and witness a remarkable surge in user engagement and conversion rates. Discover a hassle-free approach to captivating your audience and driving your CPA marketing strategy to new heights, all at your fingertips, courtesy of Re-Skinning Group's innovative and groundbreaking offering.

Features

Automated Movie Fetching :
- The script automatically fetches movies from TheMovieDB API, ensuring an up-to-date collection of movies for users.
Multi-Language Support :
- Users can access the Download / Watch the mmovies in five different languages - English, French, Spanish, German, and Italian.
Movie Download Options :
- Users have the option to download movies in six different qualities upon completion of a CPA offer.
Online Movie Streaming :
- Users can stream movies online. However, the movie playback is paused after a specific duration in config.php, prompting users to complete a CPA offer to continue watching.
SEO Optimization :
- The script is optimized for search engines, ensuring that the website ranks well in search results, driving organic traffic.
Mobile-Friendly Design :
- The website is designed to be responsive and mobile-friendly, providing an optimal viewing experience across various devices.

Script Configuration Guide

The config.php file can be found in the config folder of the repository. To access it, navigate to the root directory and then open the config folder. In the config.php file, you can set various parameters and values to configure the website's functionality. Make sure to update the necessary fields as per the provided guidelines above.


<?php  

  $Re_skinning_Grp_uri = 'https://www.re-skinning.com/cpa/landing6';	                 // Website Link
  
  $Re_skinning_Grp_wname = 'Movies';	                                                 // Website Title
  
  $Re_skinning_Grp_descrip = 'Free Movies';	                                         // Website Description

  $Re_skinning_Grp_adbluemedia_it = '1444147';	                                         // AdBlueMedia IT
  
  $Re_skinning_Grp_adbluemedia_key = 'e619c';	                                         // AdBlueMedia KEY

  $Re_skinning_Grp_ImdbApi = 'b7cd3340a794e5a2f35e3abb820b497f';	                 // Themoviedb API

  $Re_skinning_Grp_video_mp4 = 'https://cdn.jsdelivr.net/gh/iDevMore/tvs-vd1/nfx.mp4';	 // Video Link
  
  $Re_skinning_Grp_pause_time = '5';	                                                 // Time to Stop Movie

  $Re_skinning_Grp_comingsoon = '1';	                                                 // 1 to display
  
  $Re_skinning_Grp_related = '1'; 	                                                 // 1 to display

?>

To configure the RE-SKINNING CPA Movie Streaming and Download Landing Page, follow the steps below :

Link to Website : Example : https://example.com/
Website Name : Your website name
Website Description : A short description for your website
adbluemedia IT : Your AdblueMedia Locker IT - Example : 1444147 - Get it from adbluemedia
adbluemedia Key : Your AdblueMedia Locker Key - Example : e619c - Get it from adbluemedia
TMDB API Key : Your TMDB Api Key - Example : b7cd3340a794e5a2f35e3abb820b497f - Get it from The Movie Database (TMDB)
MP4 Video Link : Your MP4 Video Link Example : https://cdn.jsdelivr.net/gh/iDevMore/tvs-vd1/nfx.mp4
Set Time to Stop Movie : Set the time in seconds to pause the movie and prompt users to complete a CPA offer: [Insert Time in Seconds]
Show Coming Soon : Toggle to show or hide the "Coming Soon" section: [Insert 0 or 1]
Show Related Movies : Toggle to show or hide related movies on the movie page: [Insert 0 or 1]

Make sure to fill in the required information accurately. If you encounter any issues during the configuration process, refer to the script documentation for further guidance, or contact me here Mohammed Cha

SPEED0U/StarCitizenTranslations

2023-10-16T01:33:52Z

Here is a repository listing every translated localizations for the game.

StarCitizenTranslations

Here is a repository listing every translated localizations for the game. The original translations are made with Google Translate API, there is things to correct.

Table des matières :

Installation Automatic EN

Download the Powershell script by clicking here.

Place the file install_fr.ps1 in the folder C:\PATH\TO\GAME\Robert Space Industries\StarCitizen.

Execute the install_fr.ps1 with Powershell either by double clicking it or by right clicking and selecting Execute with Powershell.

Follow the instructions.

⚠️ - With this method, you just have to re-execute the script in order to update the translation file

Installation Manual EN

Download the repository files with the green "Code" button.

Extract the desired language in C:\PATH\TO\GAME\Robert Space Industries\StarCitizen\LIVE\data\Localization

Create a user.cfg file in C:\PATH\TO\GAME\Robert Space Industries\StarCitizen\LIVE if you don't have yet.

In user.cfg add a line with g_language = and after the = write the language folder you downloaded (ex: g_language = french_(france))

Save, start the game and enjoy!

Installation Automatique FR

Télécharger le script Powershell ici.

Placer le fichier install_fr.ps1 dans le dossier C:\PATH\TO\GAME\Robert Space Industries\StarCitizen.

Exécuter le fichier install_fr.ps1 avec l'application Windows Powershell ou double-cliquez sur le fichier ou clique droit sur le fichier et sélectionnez Exécuter avec Powershell.

Suivez les instructions sur l'écran du Powershell.

⚠️ - Avec cette méthode, vous avez juste à ré-exécuter le fichier install_fr.ps1 afin de mettre à jour automatiquement le fichier de traduction.

Installation Manuel FR

Télécharger les fichiers du répertoire avec le bouton vert Code en haut à droite.

Extraire le language désiré dans le dossier C:\PATH\TO\GAME\Robert Space Industries\StarCitizen\LIVE\data\Localization

Créer un fichier user.cfg (activé les extensions des fichiers dans les paramètres de Windows) dans le dossier C:\PATH\TO\GAME\Robert Space Industries\StarCitizen\LIVE si vous en avez pas déjà un.

Dans le fichier user.cfg ajouter une ligne g_language= puis ajouter le language désiré après le =, exemple : g_language=french_(france)

Enregistrer le fichier puis vous pourrez démarrer le jeu.

How to contribute ?

Thanks to Tasul, the French speakers can now contribute in fixing the already translated FR translation.

Link: https://speedou.sc.tasul.fr/

Known issues (FR)

Letters with accents such as "é","à","ö" etc. either do not appear or they are smaller than what it should be due to a lack of support by the game.

More translations will come later.

mthcht/awesome-lists

2023-10-16T01:33:52Z

Security lists for SOC detections

ThreatHunting:

SOC Lists:

Lists

SIEM/SOC related

Investigation

TI

More TI

Sandbox

Data manipulation

Detection Resources

Security News

Others

spdustin/ChatGPT-AutoExpert

2023-10-16T01:34:10Z

🚀🧠💬 Supercharged Custom Instructions for ChatGPT (non-coding) and ChatGPT Advanced Data Analysis (coding).

ChatGPT AutoExpert

by Dustin Miller • Reddit • Substack

License: Attribution-NonCommercial-ShareAlike 4.0 International

Elevating Conversational AI to Expert Level

Want to support these free prompts? My Substack offers paid subscriptions, that's the best way to show your appreciation.

Introduction

Getting Started

To get started with ChatGPT AutoExpert, choose which set of custom instructions you want to use:

AutoExpert ("Standard Edition")
(for non-coding tasks)
AutoExpert ("Developer Edition")
(requires GPT-4 with Advanced Data Analysis)

Features

"Standard Edition"

✳️ New to v5: Automatically Improves your Question
Many of us still compose ambiguous questions when asking ChatGPT for help. The AutoExpert will automatically rewrite your question to be precise, and to elicit the best response the experts can provide.
✳️ New to v5: Slash Commands
Slash commands offer an easy way to interact with the AutoExpert system. Get summaries, ideas for additional questions, alternative viewpoints…even ask ChatGPT to review its own answer and suggest improvements.
✳️ New to v5: Auto-selects Frameworks and Methodologies
Designed to select a context-appropriate framework for formulating its best answers
Maximized Depth and Nuance
Receive high-quality, in-depth, and ✳️ New to v5: multi-turn responses (GPT-4 only) without compromising on the granularity of the information.
Perfect for Everyday Use
No need to switch these instructions on and off. They'll give you a greatly improved experience with ChatGPT, even if you're writing code. Although, if you are writing code, you should check the Developer Edition
Automatically Identifies the Best Expert
The AutoExpert custom instruction automatically finds the best expert roles to answer whatever question you ask, every time. You don't need a bunch of special prompts any more—this works with even the simplest of prompts!
Minimized Hand-Holding
Cut through the noise and get straight to the facts, reducing unnecessary disclaimers.
Explicit Reasoning
Your AutoExpert doesn't just provide answers; it offers an explanation, detailing the thought process behind each response.
Resourceful Links
Automatically generates inline links for related topics and "you may also like" topics, helpfully linked to Google search results to avoid hallucination (GPT-3.5 still hallucinates here, but not always. GPT-4 is rock-solid).

"Developer Edition"

[!IMPORTANT] This requires a ChatGPT professional subscription, as it needs both GPT-4 and Advanced Data Analysis!

Verbosity Selection
Easily choose the complexity of the generated code, from compact "code golf" type responses, up to complex, modular code samples
Powered by Jupyter
ChatGPT Advanced Data Analysis already runs a Jupyter kernel under the hood. AutoExpert (Developer Edition) comes with a companion Python script that you simply upload to your conversation. It will automatically take advantage of the sandbox Python environment for editing longer code samples, and activate a handful of extra "slash commands" to make your life even easier.
Pick Up Where You Left Off
You can start a new chat without worrying about ChatGPT forgetting what you were doing in the previous one. The /memory slash command will download all your files, and a history of everything that's been done during your session. Simply upload it (along with the companion script) in a new session, and pick up where you left off.
Install Custom Wheels
Yeah, you heard me. Wheels for Python packages can be uploaded and installed automatically.
- Note that your ChatGPT sandbox uses Python 3.8, on a VM with x86_64 architecture (as of this writing).
Save Your Work
Among other /slash commands, AutoExpert (Developer Edition) will save all your code snippets, dehydrate its memory of your requirements and the work it's done—even back up the code cells themselves. Then it zips it up, and you can quickly download your coding conversation history.
File and Symbol Tree
By keeping a running history along with a file/symbol tree at the end of each response, ChatGPT will always remember what it just did, and you'll always see what files still need work. It's even smart enough to handle breaking down complex requirements in a way that allows it to write code over multiple turns.

ChatGPT AutoExpert (both standard and "Developer Edition")
by Dustin Miller is licensed under Attribution-NonCommercial-ShareAlike 4.0 International

Link-AGI/AutoAgents

2023-10-16T01:34:10Z

Generate different roles for GPTs to form a collaborative entity for complex tasks.

AutoAgents: A Framework for Automatic Agent Generation

Generate different roles for GPTs to form a collaborative entity for complex tasks.

AutoAgents is an experimental open-source application for An Automatic Agents Generation Experiment based on LLM. This program, driven by LLM, autonomously generates multi-agents to achieve whatever goal you set.

💥 Updates

2023.09.31: 📝 We're excited to share our paper AutoAgents: A Framework for Automatic Agent Generation related to this repository.

2023.08.30: 🚀 Adding a custom agent collection, AgentBank, allows you to add custom agents.

🚀 Features

Planner: Determines the expert roles to be added and the specific execution plan according to the problem.
Tools: The set of tools that can be used, currently only compatible with the search tools.
Observers: Responsible for reflecting on whether the planner and the results in the execution process are reasonable, currently including reflection checks on Agents, Plan, and Action.
Agents: Expert role agents generated by the planner, including name, expertise, tools used, and LLM enhancement.
Plan: The execution plan is composed of the generated expert roles, each step of the execution plan has at least one expert role agent.
Actions: The specific actions of the expert roles in the execution plan, such as calling tools or outputting results.

Demo

Online demo:

Demo / HuggingFace Spaces

Video demo:

Rumor Verification
Gluttonous Snake

Installation and Usage

Installation

git clone https://github.com/LinkSoul-AI/AutoAgents
cd AutoAgents
python setup.py install

Configuration

Configure your OPENAI_API_KEY in any of config/key.yaml / config/config.yaml / env
Priority order: config/key.yaml > config/config.yaml > env

# Copy the configuration file and make the necessary modifications.
cp config/config.yaml config/key.yaml

Variable Name	config/key.yaml	env
OPENAI_API_KEY # Replace with your own key	OPENAI_API_KEY: "sk-..."	export OPENAI_API_KEY="sk-..."
OPENAI_API_BASE # Optional	OPENAI_API_BASE: "https://<YOUR_SITE>/v1"	export OPENAI_API_BASE="https://<YOUR_SITE>/v1"

Usage

Commandline mode:

python main.py --mode commandline --llm_api_key YOUR_OPENAI_API_KEY --serapi_key YOUR_SERPAPI_KEY --idea "Is LK-99 really a room temperature superconducting material?"

Websocket service mode:

python main.py --mode service --host "127.0.0.1" --port 9000

Docker

Build docker image:

IMAGE="linksoul.ai/autoagents"
VERSION=1.0

docker build -f docker/Dockerfile -t "${IMAGE}:${VERSION}" .

Start docker container:

docker run -it --rm -p 7860:7860 "${IMAGE}:${VERSION}"

Open http://127.0.0.1:7860 in the browser.

Contact Information

If you have any questions or feedback about this project, please feel free to contact us. We highly appreciate your suggestions!

Email: gy.chen@foxmail.com, ymshi@linksoul.ai
GitHub Issues: For more technical inquiries, you can also create a new issue in our GitHub repository.

We will respond to all questions within 2-3 business days.

License

MIT license

Citation

If you find our work and this repository useful, please consider giving a star ⭐ and citation 🍺:

@article{chen2023auto,
  title={AutoAgents: The Automatic Agents Generation Framework},
  author={Chen, Guangyao and Dong, Siwei and Shu, Yu and Zhang, Ge and Jaward, Sesay and Börje, Karlsson and Fu, Jie and Shi, Yemin},
  journal={arXiv preprint},
  year={2023}
}

Wechat Group

Acknowledgements

The system, action_bank and role_bank of this code base is built using MetaGPT

Icons in the framework made by Darius Dan, Freepik, kmg design, Flat Icons, Vectorslab from FlatIcon

lukeboi/scroll-first-letters

2023-10-16T01:34:10Z

Show-1: Marrying Pixel and Latent Diffusion Models for Text-to-Video Generation

🎬Show-1

David Junhao Zhang^* Jay Zhangjie Wu^* Jia-Wei Liu^*
Rui Zhao Lingmin Ran Yuchao Gu Difei Gao Mike Zheng Shou^✉

Show Lab, National University of Singapore
^* Equal Contribution ^✉ Corresponding Author

Project Page | arXiv | PDF

News

[10/12/2023] Code and weights released!

Setup

Requirements

pip install -r requirements.txt

Pytorch 2.0+ is highly recommended for more efficiency and speed on GPUs.

Weights

All weights are available in show lab huggingface! Please check key frames generation, interpolation, superresolution stage 1 and superresolution stage 2 modules. We also use deep-floyd-if superresolution stage 1 model for the first frame superresolution. To download deep-floyd-if models, you need follow their official instructions.

Inference

To run diffusion models for text-to-video generation, run this command:

python run_inference.py

The output videos from different modules will be stored in "outputs" folder with the gif format. The code will automatically download module weights from huggingface. Otherwise, you can download weights manually with git lfs then change the "pretrained_model_path" to your local path. Take key frames generation module for example:

git lfs install
git clone https://huggingface.co/showlab/show-1-base

Demo Video

https://github.com/showlab/Show-1/assets/55792387/32242135-25a5-4757-b494-91bf314581e8

Citation

If you make use of our work, please cite our paper.

@misc{zhang2023show1,
      title={Show-1: Marrying Pixel and Latent Diffusion Models for Text-to-Video Generation}, 
      author={David Junhao Zhang and Jay Zhangjie Wu and Jia-Wei Liu and Rui Zhao and Lingmin Ran and Yuchao Gu and Difei Gao and Mike Zheng Shou},
      year={2023},
      eprint={2309.15818},
      archivePrefix={arXiv},
      primaryClass={cs.CV}
}

Shoutouts

This code heavily builds on diffusers, deep-floyd-if, modelscope, zeroscope. Thanks for open-sourcing!

epiverse-trace/serofoi

2023-10-17T01:38:12Z

Estimates the Force-of-Infection of a given pathogen from population based sero-prevalence studies

serofoi: force-of-infection from population based serosurveys with age-disagregated data

serofoi is an R package to estimate the Force-of-Infection (FoI) of a given pathogen from age-disaggregated population-based cross-sectional serosurveys, using a Bayesian framework. The package provides a set of features for assessing model fitting, convergence and visualisation.

serofoi relies on the rstan package, which provides an R interface for the Stan programming language for statistical Bayesian modelling. Particularly, serofoi relies on the use of a Hamiltonian Monte Carlo (HCM) algorithm implemented by Stan for Markov chain Monte Carlo (MCMC) sampling. The implemented methods are outlined in (Cucunubá et al. 2017) and (Carrera et al. 2020) (see FoI Models for further details)

serofoi is part of the Epiverse Initiative.

Installation

You can install the development version of serofoi from GitHub with:

if(!require("remotes")) install.packages("remotes")
remotes::install_github("epiverse-trace/serofoi")

Quick start

serofoi provides a minimal serosurvey dataset, serodata, that can be used to test out the package.

# Load example dataset chagas2012 included with the package
data(chagas2012)
head(chagas2012, 5)
#>       survey total counts age_min age_max tsur country  test         antibody
#> 1 COL-035-93    34      0       1       1 2012     COL ELISA IgG anti-T.cruzi
#> 2 COL-035-93    25      0       2       2 2012     COL ELISA IgG anti-T.cruzi
#> 3 COL-035-93    35      1       3       3 2012     COL ELISA IgG anti-T.cruzi
#> 4 COL-035-93    29      0       4       4 2012     COL ELISA IgG anti-T.cruzi
#> 5 COL-035-93    36      0       5       5 2012     COL ELISA IgG anti-T.cruzi

The function prepare_serodata will prepare the entry data for the use of the modelling module; this function computes the sample size, the years of birth and the binomial confidence interval for each age group in the provided dataset. A visualisation of the prepared seroprevalence data can be obtained using the function plot_seroprev:

serodata_test <- prepare_serodata(chagas2012)
plot_seroprev(serodata_test, size_text = 15)

Contributions

Contributors to the project include:

Zulma M. Cucunubá (author, maintainer)
Nicolás Tórres (author)
Benjamin Lambert (author)
Pierre Nouvellet (author)
Miguel Gamez (contributor)
Geraldine Gómez (contributor)
Jaime A. Pavlich-Mariscal (contributor)

Package vignettes

More details on how to use serofoi can be found in the online documentation as package vignettes, under Get Started, An Introduction to FoI Models and Real-life Use Cases for serofoi

Help

To report a bug please open an issue.

Contribute

Contributions to serofoi are welcomed. Please follow the package contributing guide.

Code of conduct

Please note that the serofoi project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

References

Carrera, Jean-Paul, Zulma M. Cucunubá, Karen Neira, Ben Lambert, Yaneth Pittí, Jesus Liscano, Jorge L. Garzón, et al. 2020. “Endemic and Epidemic Human Alphavirus Infections in Eastern Panama: An Analysis of Population-Based Cross-Sectional Surveys.” The American Journal of Tropical Medicine and Hygiene 103 (6): 2429–37. https://doi.org/10.4269/ajtmh.20-0408.

Cucunubá, Zulma M, Pierre Nouvellet, Lesong Conteh, Mauricio Javier Vera, Victor Manuel Angulo, Juan Carlos Dib, Gabriel Jaime Parra -Henao, and María Gloria Basáñez. 2017. “Modelling Historical Changes in the Force-of-Infection of Chagas Disease to Inform Control and Elimination Programmes: Application in Colombia.” BMJ Global Health 2 (3): e000345. https://doi.org/10.1136/bmjgh-2017-000345.

insightsengineering/teal.transform

2023-10-17T01:38:12Z

Reproducible transform and merge module for teal applications

teal.transform

This package contains functions and shiny modules for extracting and merging data within the teal framework.

Installation

# stable versions
install.packages('teal.transform', repos = c('https://insightsengineering.r-universe.dev', getOption('repos')))

# install.packages("pak")
pak::pak("insightsengineering/teal.transform@*release")

Alternatively, you might want to use the development version available on r-universe.

# beta versions
install.packages('teal.transform', repos = c('https://pharmaverse.r-universe.dev', getOption('repos')))

# install.packages("pak")
pak::pak("insightsengineering/teal.transform")

Usage

To understand how to use this package, please refer to the Getting Started article, which provides multiple examples of code implementation.

Below is a small example usage:

library(teal.transform)
ADSL <- teal.transform::rADSL

adsl_extract <- data_extract_spec(
  dataname = "ADSL",
  filter = filter_spec(vars = "SEX", choices = c("F", "M")),
  select = select_spec(choices = c("BMRKR1", "AGE"))
)

ui <- data_extract_ui(
  id = "adsl_ui",
  label = "ADSL UI",
  data_extract_spec = adsl_extract
)

library(shiny)
ui <- fluidPage(ui)
server <- function(input, output, session) {}
shinyApp(ui, server)

Getting help

If you encounter a bug or you have a feature request - please file an issue. For questions, discussions and staying up to date, please use the "teal" channel in the pharmaverse slack workspace.

Stargazers and Forkers

Stargazers over time

Stargazers

Forkers

insightsengineering/teal.reporter

2023-10-17T01:38:12Z

Create and preview reports with Shiny modules

teal.reporter

teal.reporter empowers both shiny and teal applications to seamlessly integrate reporting functionality. Developers, whether working on a shiny app or a teal module, define the report's content, while teal.reporter takes care of the rest.

This package provides:

A shiny module for adding cards (i.e. items) into a report
A shiny module for previewing the report on-screen
The ability to download a zip file containing the reports

Installation

# stable versions
install.packages('teal.reporter')

# install.packages("pak")
pak::pak("insightsengineering/teal.reporter@*release")

Alternatively, you might want to use the development version available on r-universe.

# beta versions
install.packages('teal.reporter', repos = c('https://pharmaverse.r-universe.dev', getOption('repos')))

# install.packages("pak")
pak::pak("insightsengineering/teal.reporter")

Usage

To understand how to use this package, please refer to the Getting Started article, which provides multiple examples of code implementation.

Getting help

If you encounter a bug or you have a feature request - please file an issue. For questions, discussions and staying up to date, please use the "teal" channel in the pharmaverse slack workspace.

Stargazers and Forkers

Stargazers over time

Stargazers

Forkers

uemurax/morg

2023-10-17T01:38:18Z

Organize mathematical thoughts

HaseebBiya18/HacktoberFest23-GFG-3

2023-10-17T01:38:45Z

HacktoberFest GFG BVDU DET NM

rpavlov/Gyst2

2023-10-16T01:35:28Z

Goliath is a non-blocking Ruby web server framework

Goliath

Goliath is an open source version of the non-blocking (asynchronous) Ruby web server framework. It is a lightweight framework designed to meet the following goals: bare metal performance, Rack API and middleware support, simple configuration, fully asynchronous processing, and readable and maintainable code (read: no callbacks).

The framework is powered by an EventMachine reactor, a high-performance HTTP parser and Ruby 1.9+ runtime. The one major advantage Goliath has over other asynchronous frameworks is the fact that by leveraging Ruby fibers introduced in Ruby 1.9+, it can untangle the complicated callback-based code into a format we are all familiar and comfortable with: linear execution, which leads to more maintainable and readable code.

Each HTTP request within Goliath is executed within its own Ruby fiber and all asynchronous I/O operations can transparently suspend and later resume the processing without requiring the developer to write any additional code. Both request processing and response processing can be done in fully asynchronous fashion: streaming uploads, firehose API's, request/response, websockets, and so on.

Installation & Prerequisites

Install Ruby 1.9 (via RVM or natively)

$> gem install rvm
$> rvm install 1.9.3
$> rvm use 1.9.3

Install Goliath:

$> gem install goliath

Getting Started: Hello World

require 'goliath'

class Hello < Goliath::API
  def response(env)
    [200, {}, "Hello World"]
  end
end

> ruby hello.rb -sv
> [97570:INFO] 2011-02-15 00:33:51 :: Starting server on 0.0.0.0:9000 in development mode. Watch out for stones.

See examples directory for more hands-on examples of building Goliath powered web-services.

Performance: MRI, JRuby, Rubinius

Goliath is not tied to a single Ruby runtime - it is able to run on MRI Ruby, JRuby and Rubinius today. Depending on which platform you are working with, you will see different performance characteristics. At the moment, we recommend MRI Ruby 1.9.3+ as the best performing VM: a roundtrip through the full Goliath stack on MRI 1.9.3 takes ~0.33ms (~3000 req/s).

Goliath has been used in production environments for 2+ years, across many different companies: PostRank (now Google), OMGPOP (now Zynga), GameSpy, and many others.

FAQ

How does Goliath compare to other Ruby async app-servers like Thin?
- They are similar (both use Eventmachine reactor), but also very different. Goliath is able to run on different Ruby platforms (see above), uses a different HTTP parser, supports HTTP keepalive & pipelining, and offers a fully asynchronous API for both request and response processing.
How does Goliath compare to Mongrel, Passenger, Unicorn?
- Mongrel is a threaded web-server, and both Passenger and Unicorn fork an entire VM to isolate each request from each other. By contrast, Goliath builds a single instance of the Rack app and runs all requests in parallel through a single VM, which leads to a much smaller memory footprint and less overhead.
How do I deploy Goliath in production?
- We recommend deploying Goliath behind a reverse proxy such as HAProxy (sample config), Nginx or equivalent. Using one of the above, you can easily run multiple instances of the same application and load balance between them within the reverse proxy.

Guides

Hands-on applications:

If you are you new to EventMachine, or want a detailed walk-through of building a Goliath powered API? You're in luck, a super-awesome Pluralsight screencast which will teach you all you need to know:

Meet EventMachine - introduction to EM, Fibers, building an API with Goliath

Additionally, you can also watch this presentation from GoGaRuCo 2011, which describes the design and motivation behind Goliath:

0-60 with Goliath: Building high performance web services

Other resources:

Discussion and Support

License & Acknowledgments

Goliath is distributed under the MIT license, for full details please see the LICENSE file.

danielschuster-muc/potter-db

2023-10-16T01:35:28Z

A set of Rails responders to dry up your application

Responders

A set of responders modules to dry up your Rails app.

Installation

Add the responders gem to your Gemfile:

gem "responders"

Update your bundle and run the install generator:

$ bundle install
$ rails g responders:install

If you are including this gem to support backwards compatibilty for responders in previous releases of Rails, you only need to include the gem and bundle.

$ bundle install

Responders Types

FlashResponder

Sets the flash based on the controller action and resource status. For instance, if you do: respond_with(@post) on a POST request and the resource @post does not contain errors, it will automatically set the flash message to "Post was successfully created" as long as you configure your I18n file:

  flash:
    actions:
      create:
        notice: "%{resource_name} was successfully created."
      update:
        notice: "%{resource_name} was successfully updated."
      destroy:
        notice: "%{resource_name} was successfully destroyed."
        alert: "%{resource_name} could not be destroyed."

In case the resource contains errors, you should use the failure key on I18n. This is useful to dry up flash messages from your controllers. Note: by default alerts for update and destroy actions are commented in generated I18n file. If you need a specific message for a controller, let's say, for PostsController, you can also do:

  flash:
    posts:
      create:
        notice: "Your post was created and will be published soon"

This responder is activated in all non get requests. By default it will use the keys :notice and :alert, but they can be changed in your application:

config.responders.flash_keys = [ :success, :failure ]

You can also have embedded HTML. Just create a _html scope.

  flash:
    actions:
      create:
        alert_html: "<strong>OH NOES!</strong> You did it wrong!"
    posts:
      create:
        notice_html: "<strong>Yay!</strong> You did it!"

See also the namespace_lookup option to search the full hierarchy of possible keys.

HttpCacheResponder

Automatically adds Last-Modified headers to API requests. This allows clients to easily query the server if a resource changed and if the client tries to retrieve a resource that has not been modified, it returns not_modified status.

CollectionResponder

Makes your create and update action redirect to the collection on success.

LocationResponder

This responder allows you to use callable objects as the redirect location. Useful when you want to use the respond_with method with a custom route that requires persisted objects, but the validation may fail.

Note: this responder is included by default, and doesn't need to be included on the top of your controller (including it will issue a deprecation warning).

class ThingsController < ApplicationController
  respond_to :html

  def create
    @thing = Thing.create(params[:thing])
    respond_with @thing, location: -> { thing_path(@thing) }
  end
end

Dealing with namespaced routes

In order for the LocationResponder to find the correct route helper for namespaced routes you need to pass the namespaces to respond_with:

class Api::V1::ThingsController < ApplicationController
  respond_to :json

  # POST /api/v1/things
  def create
    @thing = Thing.create(thing_params)
    respond_with :api, :v1, @thing
  end
end

Configuring your own responder

Responders only provides a set of modules and to use them you have to create your own responder. After you run the install command, the following responder will be generated in your application:

# lib/application_responder.rb
class ApplicationResponder < ActionController::Responder
  include Responders::FlashResponder
  include Responders::HttpCacheResponder
end

Your application also needs to be configured to use it:

# app/controllers/application_controller.rb
require "application_responder"

class ApplicationController < ActionController::Base
  self.responder = ApplicationResponder
  respond_to :html
end

Controller method

This gem also includes the controller method responders, which allows you to cherry-pick which responders you want included in your controller.

class InvitationsController < ApplicationController
  responders :flash, :http_cache
end

Interpolation Options

You can pass in extra interpolation options for the translation by adding an flash_interpolation_options method to your controller:

class InvitationsController < ApplicationController
  responders :flash, :http_cache

  def create
    @invitation = Invitation.create(params[:invitation])
    respond_with @invitation
  end

  private

  def flash_interpolation_options
    { resource_name: @invitation.email }
  end
end

Now you would see the message "name@example.com was successfully created" instead of the default "Invitation was successfully created."

Generator

This gem also includes a responders controller generator, so your scaffold can be customized to use respond_with instead of default respond_to blocks. From 2.1, you need to explicitly opt-in to use this generator by adding the following to your config/application.rb:

config.app_generators.scaffold_controller :responders_controller

Failure handling

Responders don't use valid? to check for errors in models to figure out if the request was successful or not, and relies on your controllers to call save or create to trigger the validations.

def create
  @widget = Widget.new(widget_params)
  # @widget will be a valid record for responders, as we haven't called `save`
  # on it, and will always redirect to the `widgets_path`.
  respond_with @widget, location: -> { widgets_path }
end

Responders will check if the errors object in your model is empty or not. Take this in consideration when implementing different actions or writing test assertions on this behavior for your controllers.

def create
  @widget = Widget.new(widget_params)
  @widget.errors.add(:base, :invalid)
  # `respond_with` will render the `new` template again,
  # and set the status based on the configured `error_status`.
  respond_with @widget
end

Verifying request formats

respond_with will raise an ActionController::UnknownFormat if the request MIME type was not configured through the class level respond_to, but the action will still be executed and any side effects (like creating a new record) will still occur. To raise the UnknownFormat exception before your action is invoked you can set the verify_requested_format! method as a before_action on your controller.

class WidgetsController < ApplicationController
  respond_to :json
  before_action :verify_requested_format!

  # POST /widgets.html won't reach the `create` action.
  def create
    widget = Widget.create(widget_params)
    respond_with widget
  end
end

Configuring error and redirect statuses

By default, respond_with will respond to errors on HTML & JS requests using the HTTP status code 200 OK, and perform redirects using the HTTP status code 302 Found, both for backwards compatibility reasons.

You can configure this behavior by setting config.responders.error_status and config.responders.redirect_status to the desired status codes.

config.responders.error_status = :unprocessable_entity
config.responders.redirect_status = :see_other

These can also be set in your custom ApplicationResponder if you have generated one: (see install instructions)

class ApplicationResponder < ActionController::Responder
  self.error_status = :unprocessable_entity
  self.redirect_status = :see_other
end

Note: the application responder generated for new apps already configures a different set of defaults: 422 Unprocessable Entity for errors, and 303 See Other for redirects. Responders may change the defaults to match these in a future major release.

Hotwire/Turbo and fetch APIs

Hotwire/Turbo expects successful redirects after form submissions to respond with HTTP status 303 See Other, and error responses to be 4xx or 5xx statuses, for example 422 Unprocessable Entity for displaying form validation errors and 500 Internal Server Error for other server errors. Turbo documentation: Redirecting After a Form Submission.

The example configuration showed above matches the statuses that better integrate with Hotwire/Turbo.

Examples

Want more examples ? Check out these blog posts:

Supported Ruby / Rails versions

We intend to maintain support for all Ruby / Rails versions that haven't reached end-of-life.

For more information about specific versions please check Ruby and Rails maintenance policies, and our test matrix.

Bugs and Feedback

If you discover any bugs or want to drop a line, feel free to create an issue on GitHub.

grent/cosc480-homework2

2023-10-16T01:35:28Z

Rails World Hotwire Cookbook. VIEW THE PULL REQUESTS

README

This README would normally document whatever steps are necessary to get the application up and running.

Things you may want to cover:

Ruby version
System dependencies
Configuration
Database creation
Database initialization
How to run the test suite
Services (job queues, cache servers, search engines, etc.)
Deployment instructions
...

huggingface/text-embeddings-inference

2023-10-16T01:35:21Z

A blazing fast inference solution for text embeddings models

Text Embeddings Inference

A blazing fast inference solution for text embeddings models.

Benchmark for BAAI/bge-base-en-v1.5 on a Nvidia A10 with a sequence length of 512 tokens:

Get Started
No compilation step
Dynamic shapes
Small docker images and fast boot times. Get ready for true serverless!
Token based dynamic batching
Optimized transformers code for inference using Flash Attention, Candle and cuBLASLt
Safetensors weight loading
Production ready (distributed tracing with Open Telemetry, Prometheus metrics)

Get Started

Supported Models

You can use any BERT or XLM-RoBERTa model with absolute positions in text-embeddings-inference. If the model does not have safetensors weights you can convert it using this space.

Support for other model types will be added in the future.

Examples of supported models:

MTEB Rank	Model Type	Model ID	Specific Revision
1	Bert	BAAI/bge-large-en-v1.5	refs/pr/5
2		BAAI/bge-base-en-v1.5	refs/pr/1
3		llmrails/ember-v1
4		thenlper/gte-large
5		thenlper/gte-base
6		intfloat/e5-large-v2
7		BAAI/bge-small-en-v1.5	refs/pr/3
10		intfloat/e5-base-v2
11	XLM-RoBERTa	intfloat/multilingual-e5-large

You can explore the list of best performing text embeddings models here.

Docker

model=BAAI/bge-large-en-v1.5
revision=refs/pr/5
volume=$PWD/data # share a volume with the Docker container to avoid downloading weights every run

docker run --gpus all -p 8080:80 -v $volume:/data --pull always ghcr.io/huggingface/text-embeddings-inference:latest --model-id $model --revision $revision

And then you can make requests like

curl 127.0.0.1:8080/embed \
    -X POST \
    -d '{"inputs":"What is Deep Learning?"}' \
    -H 'Content-Type: application/json'

Note: To use GPUs, you need to install the NVIDIA Container Toolkit. We also recommend using NVIDIA drivers with CUDA version 12 or higher.

To see all options to serve your models:

text-embeddings-router --help

Usage: text-embeddings-router [OPTIONS]

Options:
      --model-id <MODEL_ID>
          The name of the model to load. Can be a MODEL_ID as listed on <https://hf.co/models> like `thenlper/gte-base`. Or it can be a local directory containing the necessary files as saved by `save_pretrained(...)` methods of transformers

          [env: MODEL_ID=]
          [default: thenlper/gte-base]

      --revision <REVISION>
          The actual revision of the model if you're referring to a model on the hub. You can use a specific commit id or a branch like `refs/pr/2`

          [env: REVISION=]

      --tokenization-workers <TOKENIZATION_WORKERS>
          Optionally control the number of tokenizer workers used for payload tokenization, validation and truncation. Default to the number of CPU cores on the machine

          [env: TOKENIZATION_WORKERS=]

      --dtype <DTYPE>
          The dtype to be forced upon the model

          [env: DTYPE=]
          [default: float16]
          [possible values: float16, float32]

      --max-concurrent-requests <MAX_CONCURRENT_REQUESTS>
          The maximum amount of concurrent requests for this particular deployment. Having a low limit will refuse clients requests instead of having them wait for too long and is usually good to handle backpressure correctly

          [env: MAX_CONCURRENT_REQUESTS=]
          [default: 512]

      --max-batch-tokens <MAX_BATCH_TOKENS>
          **IMPORTANT** This is one critical control to allow maximum usage of the available hardware.

          This represents the total amount of potential tokens within a batch.

          For `max_batch_tokens=1000`, you could fit `10` queries of `total_tokens=100` or a single query of `1000` tokens.

          Overall this number should be the largest possible until the model is compute bound. Since the actual memory overhead depends on the model implementation, text-embeddings-inference cannot infer this number automatically.

          [env: MAX_BATCH_TOKENS=]
          [default: 16384]

      --max-batch-requests <MAX_BATCH_REQUESTS>
          Optionally control the maximum number of individual requests in a batch

          [env: MAX_BATCH_REQUESTS=]

      --max-client-batch-size <MAX_CLIENT_BATCH_SIZE>
          Control the maximum number of inputs that a client can send in a single request

          [env: MAX_CLIENT_BATCH_SIZE=]
          [default: 32]

      --hf-api-token <HF_API_TOKEN>
          Your HuggingFace hub token

          [env: HF_API_TOKEN=]

      --hostname <HOSTNAME>
          The IP address to listen on

          [env: HOSTNAME=]
          [default: 0.0.0.0]

  -p, --port <PORT>
          The port to listen on

          [env: PORT=]
          [default: 3000]

      --uds-path <UDS_PATH>
          The name of the unix socket some text-embeddings-inference backends will use as they communicate internally with gRPC

          [env: UDS_PATH=]
          [default: /tmp/text-embeddings-inference-server]

      --huggingface-hub-cache <HUGGINGFACE_HUB_CACHE>
          The location of the huggingface hub cache. Used to override the location if you want to provide a mounted disk for instance

          [env: HUGGINGFACE_HUB_CACHE=/data]

      --json-output
          Outputs the logs in JSON format (useful for telemetry)

          [env: JSON_OUTPUT=]

      --otlp-endpoint <OTLP_ENDPOINT>
          [env: OTLP_ENDPOINT=]

      --cors-allow-origin <CORS_ALLOW_ORIGIN>
          [env: CORS_ALLOW_ORIGIN=]

Docker Images

Text Embeddings Inference ships with multiple Docker images that you can use to target a specific backend:

Architecture	Image
CPU	ghcr.io/huggingface/text-embeddings-inference:cpu-latest
Turing	ghcr.io/huggingface/text-embeddings-inference:turing-latest
Ampere 80	ghcr.io/huggingface/text-embeddings-inference:latest
Ampere 86	ghcr.io/huggingface/text-embeddings-inference:86-latest
Hopper	ghcr.io/huggingface/text-embeddings-inference:hopper-latest

API documentation

You can consult the OpenAPI documentation of the text-embeddings-inference REST API using the /docs route. The Swagger UI is also available at: https://huggingface.github.io/text-embeddings-inference.

Using a private or gated model

You have the option to utilize the HUGGING_FACE_HUB_TOKEN environment variable for configuring the token employed by text-embeddings-inference. This allows you to gain access to protected resources.

For example:

Go to https://huggingface.co/settings/tokens
Copy your cli READ token
Export HUGGING_FACE_HUB_TOKEN=<your cli READ token>

or with Docker:

model=<your private model>
volume=$PWD/data # share a volume with the Docker container to avoid downloading weights every run
token=<your cli READ token>

docker run --gpus all -e HUGGING_FACE_HUB_TOKEN=$token -p 8080:80 -v $volume:/data --pull always ghcr.io/huggingface/text-embeddings-inference:latest --model-id $model

Distributed Tracing

text-embeddings-inference is instrumented with distributed tracing using OpenTelemetry. You can use this feature by setting the address to an OTLP collector with the --otlp-endpoint argument.

Local install

CPU

You can also opt to install text-embeddings-inference locally.

First install Rust:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Then run:

cargo install --path router -F candle --no-default-features

You can now launch Text Embeddings Inference on CPU with:

model=BAAI/bge-large-en-v1.5
revision=refs/pr/5

text-embeddings-router --model-id $model --revision $revision --port 8080

Note: on some machines, you may also need the OpenSSL libraries and gcc. On Linux machines, run:

sudo apt-get install libssl-dev gcc -y

Cuda

Make sure you have Cuda and the nvidia drivers installed. We recommend using NVIDIA drivers with CUDA version 12 or higher. You also need to add the nvidia binaries to your path:

export PATH=$PATH:/usr/local/cuda/bin

Then run:

# This can take a while as we need to compile a lot of cuda kernels
cargo install --path router -F candle-cuda --no-default-features

You can now launch Text Embeddings Inference on GPU with:

model=BAAI/bge-large-en-v1.5
revision=refs/pr/5

text-embeddings-router --model-id $model --revision $revision --port 8080

ptrdom/scalajs-esbuild

2023-10-16T01:35:45Z

lean 4 typechecker in scala (based on Gabriel Ebner's trepplein)

trepplein: a Lean type-checker

Lean is an interactive theorem prover based on dependent type theory. For additional trust, Lean can export the generated proofs so that they can be independently verified. Trepplein is a tool that can check these exported proofs.

Trepplein is written in Scala, and requires SBT to build.

sbt stage
./target/universal/stage/bin/trepplein .../export.out

Other checkers

tc, a type-checker written in Haskell.
leanchecker, a bare-bones version of the Lean kernel.

department-of-veterans-affairs/github-handbook

2023-10-16T01:35:54Z

A handbook of how the VA uses GitHub

oculus-samples/Unity-DepthAPI

2023-10-16T01:35:56Z

Examples of using Depth API for real-time, dynamic occlusions

UbuntuAsahi/ubuntu-asahi

2023-10-16T01:36:00Z

Native Ubuntu images for Apple silicon hardware

Ubuntu Apple Silicon Image

This is repository contains scripts for compiling native Ubuntu images for Apple silicon hardware such as the Apple M1 and M2.

Hosted Installer

To install a prebuilt image run:

curl -sL https://ubuntuasahi.org/install > install.sh	# Download
less install.sh						# Review
sh install.sh						# Run

or if you like to live dangerously:

curl -sL https://ubuntuasahi.org/install | bash

The installer offers a choice of different Ubuntu releases and build configurations.

Currently supported are:

Ubuntu Desktop 23.04
Ubuntu Desktop 22.04 LTS
Ubuntu Server 22.04 LTS

The default username and password are both ubuntu. Root access can be achieved via sudo.

Can I dual-boot macOS and Linux?

Yes! The installer can automatically resize your macos partition according to your liking and install Ubuntu in the freed up space. Removing macos is not even supported at the moment since it is required to update the system firmware.

Building

If you do not want to use the prebuilt disk image, you can build one yourself with the instructions below.

Install dependencies

# Install dependencies
sudo apt-get install arch-install-scripts debootstrap mtools parted gnupg eatmydata rsync git squashfs-tools zip
# Install dependencies, if your builder system is NOT arm64
sudo apt-get install binfmt-support qemu qemu-user-static

Build everything

cd ubuntu-asahi
# Build the entire live image
sudo ./build-generic.sh

The live GPT image file will be output to build/ubuntu.live.img, the zip archive for the Asahi Linux installer will be output to build/ubuntu.live.img.zip.

Clean

The clean.sh script will do exactly what it says - it will clean up the build folder, except for the cache folder, which is used by debootstrap to cache debs.

cd ubuntu-asahi
# Clean the build folder
./clean.sh

Related Projects

calcom/docker

2023-10-16T01:36:00Z

The Docker configuration for Cal.com is an effort powered by people within the community. Cal.com, Inc. does not provide official support for Docker, but we will accept fixes and documentation. Use at your own risk.

Cal.com (formerly Calendso)

The open-source Calendly alternative. (Docker Edition)
Learn more »

Slack · Website · Core Cal.com related Issues · Docker specific Issues · Roadmap

Docker

This image can be found on DockerHub at https://hub.docker.com/r/calcom/cal.com

The Docker configuration for Cal.com is an effort powered by people within the community. Cal.com, Inc. does not yet provide official support for Docker, but we will accept fixes and documentation at this time. Use at your own risk.

Important Notes

This Docker Image is managed by the Cal.com Community. Join the team here. Support for this image can be found via the repository, located at https://github.com/calcom/docker

Currently, this image is intended for local development/evaluation use only, as there are specific requirements for providing environmental variables at build-time in order to specify a non-localhost BASE_URL. (this is due to the nature of the static site compilation, which embeds the variable values). The ability to update these variables at runtime is in-progress and will be available in the future.

For Production, for the time being, please checkout the repository and build/push your own image privately.

Requirements

Make sure you have docker & docker compose installed on the server / system. Both are installed by most docker utilities, including Docker Desktop and Rancher Desktop.

Note: docker compose without the hyphen is now the primary method of using docker-compose, per the Docker documentation.

(Most users) Running Cal.com with Docker Compose

If you are evaluating Cal.com or running with minimal to no modifications, this option is for you.

Clone calcom/docker

git clone https://github.com/calcom/docker.git

Change into the directory
```
cd docker
```
Prepare your configuration: Rename .env.example to .env and then update .env
```
cp .env.example .env
```
Most configurations can be left as-is, but for configuration options see Important Run-time variables below.

Update the appropriate values in your .env file, then proceed.
(optional) Pre-Pull the images by running the following command:
```
docker compose pull
```
This will use the default image locations as specified by image: in the docker-compose.yaml file.

Note: To aid with support, by default Scarf.sh is used as registry proxy for download metrics.
Start Cal.com via docker compose

(Most basic users, and for First Run) To run the complete stack, which includes a local Postgres database, Cal.com web app, and Prisma Studio:
```
docker compose up -d
```
To run Cal.com web app and Prisma Studio against a remote database, ensure that DATABASE_URL is configured for an available database and run:
```
docker compose up -d calcom studio
```
To run only the Cal.com web app, ensure that DATABASE_URL is configured for an available database and run:
```
docker compose up -d calcom
```
Note: to run in attached mode for debugging, remove -d from your desired run command.
Open a browser to http://localhost:3000, or your defined NEXT_PUBLIC_WEBAPP_URL. The first time you run Cal.com, a setup wizard will initialize. Define your first user, and you're ready to go!

Updating Cal.com

Stop the Cal.com stack
```
docker compose down
```
Pull the latest changes
```
docker compose pull
```
Update env vars as necessary.
Re-start the Cal.com stack
```
docker compose up -d
```

(Advanced users) Build and Run Cal.com

Clone calcom/docker

git clone https://github.com/calcom/docker.git calcom-docker

Change into the directory
```
cd calcom-docker
```
Update the calcom submodule.
```
git submodule update --remote --init
```
Note: DO NOT use recursive submodule update, otherwise you will receive a git authentication error.
Rename .env.example to .env and then update .env

For configuration options see Build-time variables below. Update the appropriate values in your .env file, then proceed.
Build the Cal.com docker image:

Note: Due to application configuration requirements, an available database is currently required during the build process.

a) If hosting elsewhere, configure the DATABASE_URL in the .env file, and skip the next step

b) If a local or temporary database is required, start a local database via docker compose.
```
docker compose up -d database
```
Build Cal.com via docker compose (DOCKER_BUILDKIT=0 must be provided to allow a network bridge to be used at build time. This requirement will be removed in the future)
```
DOCKER_BUILDKIT=0 docker compose build calcom
```
Start Cal.com via docker compose

(Most basic users, and for First Run) To run the complete stack, which includes a local Postgres database, Cal.com web app, and Prisma Studio:
```
docker compose up -d
```
To run Cal.com web app and Prisma Studio against a remote database, ensure that DATABASE_URL is configured for an available database and run:
```
docker compose up -d calcom studio
```
To run only the Cal.com web app, ensure that DATABASE_URL is configured for an available database and run:
```
docker compose up -d calcom
```
Note: to run in attached mode for debugging, remove -d from your desired run command.
Open a browser to http://localhost:3000, or your defined NEXT_PUBLIC_WEBAPP_URL. The first time you run Cal.com, a setup wizard will initialize. Define your first user, and you're ready to go!

Configuration

Important Run-time variables

These variables must also be provided at runtime

Variable	Description	Required	Default
CALCOM_LICENSE_KEY	Enterprise License Key	optional
NEXT_PUBLIC_WEBAPP_URL	Base URL of the site. NOTE: if this value differs from the value used at build-time, there will be a slight delay during container start (to update the statically built files).	optional	`http://localhost:3000`
NEXTAUTH_URL	Location of the auth server. By default, this is the Cal.com docker instance itself.	optional	`{NEXT_PUBLIC_WEBAPP_URL}/api/auth`
NEXTAUTH_SECRET	must match build variable	required	`secret`
CALENDSO_ENCRYPTION_KEY	must match build variable	required	`secret`
DATABASE_URL	database url with credentials	required	`postgresql://unicorn_user:magical_password@database:5432/calendso`

Build-time variables

If building the image yourself, these variables must be provided at the time of the docker build, and can be provided by updating the .env file. Currently, if you require changes to these variables, you must follow the instructions to build and publish your own image.

Updating these variables is not required for evaluation, but is required for running in production. Instructions for generating variables can be found in the cal.com instructions

Variable	Description	Required	Default
NEXT_PUBLIC_WEBAPP_URL	Base URL injected into static files	optional	`http://localhost:3000`
NEXT_PUBLIC_LICENSE_CONSENT	license consent - true/false
CALCOM_TELEMETRY_DISABLED	Allow cal.com to collect anonymous usage data (set to `1` to disable)
DATABASE_URL	database url with credentials	required	`postgresql://unicorn_user:magical_password@database:5432/calendso`
NEXTAUTH_SECRET	Cookie encryption key	required	`secret`
CALENDSO_ENCRYPTION_KEY	Authentication encryption key	required	`secret`

Git Submodules

This repository uses a git submodule.

For users building their own images, to update the calcom submodule, use the following command:

git submodule update --remote --init

For more advanced usage, please refer to the git documentation: https://git-scm.com/book/en/v2/Git-Tools-Submodules

Troubleshooting

SSL edge termination

If running behind a load balancer which handles SSL certificates, you will need to add the environmental variable NODE_TLS_REJECT_UNAUTHORIZED=0 to prevent requests from being rejected. Only do this if you know what you are doing and trust the services/load-balancers directing traffic to your service.

Failed to commit changes: Invalid 'prisma.user.create()'

Certain versions may have trouble creating a user if the field metadata is empty. Using an empty json object {} as the field value should resolve this issue. Also, the id field will autoincrement, so you may also try leaving the value of id as empty.

CLIENT_FETCH_ERROR

If you experience this error, it may be the way the default Auth callback in the server is using the WEBAPP_URL as a base url. The container does not necessarily have access to the same DNS as your local machine, and therefor needs to be configured to resolve to itself. You may be able to correct this by configuring NEXTAUTH_URL=http://localhost:3000/api/auth, to help the backend loop back to itself.

docker-calcom-1  | @calcom/web:start: [next-auth][error][CLIENT_FETCH_ERROR] 
docker-calcom-1  | @calcom/web:start: https://next-auth.js.org/errors#client_fetch_error request to http://testing.localhost:3000/api/auth/session failed, reason: getaddrinfo ENOTFOUND testing.localhost {
docker-calcom-1  | @calcom/web:start:   error: {
docker-calcom-1  | @calcom/web:start:     message: 'request to http://testing.localhost:3000/api/auth/session failed, reason: getaddrinfo ENOTFOUND testing.localhost',
docker-calcom-1  | @calcom/web:start:     stack: 'FetchError: request to http://testing.localhost:3000/api/auth/session failed, reason: getaddrinfo ENOTFOUND testing.localhost\n' +
docker-calcom-1  | @calcom/web:start:       '    at ClientRequest.<anonymous> (/calcom/node_modules/next/dist/compiled/node-fetch/index.js:1:65756)\n' +
docker-calcom-1  | @calcom/web:start:       '    at ClientRequest.emit (node:events:513:28)\n' +
docker-calcom-1  | @calcom/web:start:       '    at ClientRequest.emit (node:domain:489:12)\n' +
docker-calcom-1  | @calcom/web:start:       '    at Socket.socketErrorListener (node:_http_client:494:9)\n' +
docker-calcom-1  | @calcom/web:start:       '    at Socket.emit (node:events:513:28)\n' +
docker-calcom-1  | @calcom/web:start:       '    at Socket.emit (node:domain:489:12)\n' +
docker-calcom-1  | @calcom/web:start:       '    at emitErrorNT (node:internal/streams/destroy:157:8)\n' +
docker-calcom-1  | @calcom/web:start:       '    at emitErrorCloseNT (node:internal/streams/destroy:122:3)\n' +
docker-calcom-1  | @calcom/web:start:       '    at processTicksAndRejections (node:internal/process/task_queues:83:21)',
docker-calcom-1  | @calcom/web:start:     name: 'FetchError'
docker-calcom-1  | @calcom/web:start:   },
docker-calcom-1  | @calcom/web:start:   url: 'http://testing.localhost:3000/api/auth/session',
docker-calcom-1  | @calcom/web:start:   message: 'request to http://testing.localhost:3000/api/auth/session failed, reason: getaddrinfo ENOTFOUND testing.localhost'
docker-calcom-1  | @calcom/web:start: }

seandenigris/The-Project-Project

2023-10-17T01:39:55Z

Project Management unleashed from an "application" stovepipe, running on GToolkit (Smalltalk)

seandenigris/Objective-Lepiter

2023-10-17T01:39:55Z

powerlang/powerlang

2023-10-17T01:39:55Z

The Powerlang Bootstrapper

pajikos/home-assistant-helm-chart

2023-10-16T01:36:18Z

code-423n4/2023-10-brahma

2023-10-16T01:36:23Z

daimo-eth/p256-verifier

2023-10-16T01:36:23Z

P256 signature verification solidity contract: Fallback contract from EIP-7212 precompile

ajna-finance/ajna-core

2023-10-16T01:36:23Z

core contract of eip 4337 implementation

faithleysath/faithleysath.github.io

2023-10-17T01:40:17Z

Personal blog by hexo

acmpesuecc/Hacknight5.0_Leaderboard

2023-10-16T01:36:44Z

Leaderboard For Hacknight 5.0 Written With Sveltekit

Boom123bam/ResPawn

2023-10-16T01:36:44Z

acmpesuecc/MUNSocWebsite

2023-10-16T01:36:44Z

(prototype) Crud pages system for Svelte projects

vapor/validation

2023-10-16T01:36:50Z

📝 Read, update and write your Xcode projects

XcodeProj

XcodeProj is a library written in Swift for parsing and working with Xcode projects. It's heavily inspired by CocoaPods XcodeProj and xcode.

XcodeProj

Projects Using XcodeProj

Project	Repository
ProjLint	github.com/JamitLabs/ProjLint
rules_xcodeproj	github.com/buildbuddy-io/rules_xcodeproj
Rugby	github.com/swiftyfinch/Rugby
Sourcery	github.com/krzysztofzablocki/Sourcery
Tuist	github.com/tuist/tuist
XcodeGen	github.com/yonaskolb/XcodeGen
xspm	gitlab.com/Pyroh/xspm

If you are also leveraging XcodeProj in your project, feel free to open a PR to include it in the list above.

Installation

Swift Package Manager

Add the dependency in your Package.swift file:

let package = Package(
    name: "myproject",
    dependencies: [
        .package(url: "https://github.com/tuist/XcodeProj.git", .upToNextMajor(from: "8.12.0")),
    ],
    targets: [
        .target(
            name: "myproject",
            dependencies: ["XcodeProj"]),
        ]
)

Scripting

Using swift-sh you can automate project-tasks using scripts, for example we can make a script that keeps a project’s version key in sync with the current git tag that represents the project’s version:

#!/usr/bin/swift sh
import Foundation
import XcodeProj  // @tuist ~> 8.8.0
import PathKit

guard CommandLine.arguments.count == 3 else {
    let arg0 = Path(CommandLine.arguments[0]).lastComponent
    fputs("usage: \(arg0) <project> <new-version>\n", stderr)
    exit(1)
}

let projectPath = Path(CommandLine.arguments[1])
let newVersion = CommandLine.arguments[2]
let xcodeproj = try XcodeProj(path: projectPath)
let key = "CURRENT_PROJECT_VERSION"

for conf in xcodeproj.pbxproj.buildConfigurations where conf.buildSettings[key] != nil {
    conf.buildSettings[key] = newVersion
}

try xcodeproj.write(path: projectPath)

You could then store this in your repository, for example at scripts/set-project-version and then run it:

$ scripts/set-project-version ./App.xcodeproj 1.2.3
$ git add App.xcodeproj
$ git commit -m "Bump version"
$ git tag 1.2.3

Future adaption could easily include determining the version and bumping it automatically. If so, we recommend using a library that provides a Version object.

Documentation 📝

Want to start using XcodeProj? Start by digging into our documentation which will help you get familiar with the API and get to know more about the Xcode projects structure.

References 📚

Contributing

Git clone the repository git@github.com:tuist/xcodeproj.git.
Open Package.swift with Xcode.

License

XcodeProj is released under the MIT license. See LICENSE for details.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_{Joseph Colicchio} 🤔	_deatondg 🤔	_{Dan Fleming} 💻	_{Sascha Schwabbauer} 🤔	_{Marcin Iwanicki} 🚧	_{Adam Khazi} 🚧	_{Elliott Williams} 💻
_Muukii 🖋	_{Yuya Oka} 💻	_{Keith Smiley} 🖋	_{Ian Leitch} 💻	_{Daniil Subbotin} 💻	_{Florentin Bekier} 💻	_{Vadim Smal} 🐛
_{freddi(Yuki Aki)} 💻	_{Kristopher Jackson} 💻	_{Jake Prickett} 💻	_{Jake Adams} 💻	_matsuji 💻	_{Bogdan Belogurov} 💻	_{Chuck Grindel} 💻
_{Michael McGuire} 💻	_C-凡 💻	_{Maxwell Elliott} 💻	_{Brentley Jones} 💻	_Teameh 💻	_{Johannes Ebeling} 💻	_baegteun 📖
_{Alex Kovács} 📖	_{Christoffer Winterkvist} 💻	_{Timothy Costa} 💻	_Mary 💻	_{Md. Ibrahim Hassan} 💻	_tatagrigory 💻	_{Ruslan Alikhamov} 💻

This project follows the all-contributors specification. Contributions of any kind welcome!

fabiangruss/playful-swiftui-examples

2023-10-17T01:40:28Z

A collection of SwiftUI examples to use

playful-swiftui-examples

A growing collection of pretty SwiftUI code snippets to use in your projects based on code from my projects.

Most examples are focused on having a great UX and adding a little bit of fun for the user.

Feel free to star the repo and follow @fabiangruss on Twitter - many more examples to come :)

Playful, squishy play button

This button toggles between play and pause and is a squishy button that changes its shape when pressed. It uses a combination of animations and symbol effects to achieve a playful look.

https://github.com/fabiangruss/swiftui-examples/assets/22966490/6bba3c00-b21a-4f3e-bc69-a97642b6129a

Go to code

Squishy waveform button

This button handles audio playback (provided as Data) and displays an animated waveform when music/voicenotes are playing. Works like this:

audio data is divided into chunks
each chunk's average amplitude is converted to decibels to create waveform bars
these are rendered in SwiftUI

https://github.com/fabiangruss/swiftui-examples/assets/22966490/094e8db2-2d65-46bc-adbc-4dcd52eeb2b2

Go to code

Highlighted search

This code snippet shows how to highlight the search term in a list of results. It builds a custom HStack with multiple text elements in which the search term is highlighted and contrasted against the rest of the text.

Go to code

Custom pull to refresh/action

This code snippet shows how to build a custom pull to refresh and attach it to a scroll view. It replaces iOS' default ProgressView by your own view. This view receives the current pull down percentage from 0 to 1 to be used for custom interactions. Inspiration to this refresh view is based on kavsoft.dev

https://github.com/fabiangruss/playful-swiftui-examples/assets/22966490/dbdb39ac-f69e-412c-9a90-450a0652e329

Go to code

NYU-Processor-Design/PurdNyUart

2023-10-17T01:40:37Z

Purdue-SoCET/vito-uart

2023-10-17T01:40:37Z

oramasearch/orama

2023-10-16T01:37:26Z

🏆 Welcome to Tact Challenge

by TON Foundation

📝 Tasks

task1 - Counter contract
task2 - Proxy contract
task3 - Dex contract
task4 - NFT locker contract
task5 - NFT random swap

Each task has two parts:

📋 A comment with a description of what the smart contract should do.
💻 The code of the smart contract with one or more functions marked as testable.

The goal of the contestants is to provide a code that matches the description.

Each task may give the contestant either 0 or 5 to 6 score points: 5 for all tests passed plus "gas-score" from 0 to 1 (0 for "infinite" gas consumption, 1 for 0 gas consumption, dependence is inverse exponent).

Each TVM execution is limited to 100,000,000 (hundred million) gas units. This limit is high enough that it only rules out infinite loops. Any practical solution, regardless of how (un)optimized it is, will fit.

We ask participants not to change the signature (number, order, and types of arguments and result) of testable functions for us to be able to evaluate their submission.

📅 Solution submission guide and terms

Registration Process: Before you begin, make sure to go through the registration process via the @smartchallengebot. Your solutions will not be accepted if you are not properly registered.
Create a Private GitHub Repository: Clone this repository and set it as your own private GitHub repo. Ensuring the visibility configs are set to "private" is crucial to safeguarding your solution.
Set Your Token: Utilize the token provided to you during registration in Telegram bot and set it as a secret variable called USER_TOKEN in your private repository. You can learn more about setting secret variables in the official GitHub documentation.
Submit Your Solution: When you are ready to submit your solution, simply push your code into your private repository. The code will be sent to the task review server, and GitHub actions will display the status of your submission.
Solution Evaluation: If at least one of your solutions works well, your submission will be counted. Feel free to push solutions for more tasks; GitHub actions will run your code against tests and count successful submissions. To see a detailed report on your submission, proceed to GitHub Actions tab and you will see a similar report along with possible errors if present:

Task ID	Compiled	Tests Passed	Points	Gas Used	Compilation Error
1	❌	❌	0	N/A	Error Details
2	✅	❌ 0/6	0	0
3	✅	✅ 10/10	5.127	491,235,717
4	❌	❌	0	N/A	Error Details
5	❌	❌	0	N/A	Error Details

Check Your Points: To check your solution points, review the logs of the GitHub action for your latest commit. Additionally, you can find your solution points in the menu button inside of the Telegram bot.

Best of luck with your submissions!

‼️ Important rules:

It's forbidden to use any FunC/Fift code inside of submitted Tact solutions. Participants who will have FunC/Fift code in their submissions will be disqualified. This rule applies to Tact bindings as they're using a lower level of abstraction thus compromising the nature of Tact Challenge.
Please don't share your solution's code with anybody. If someone's submission will be suspected of using your code - both participants will be disqualified. Repeated case will cause lifetime ban from TON Smart Challenges.

🏆 Scoring and Prizes

Winners of the contest will receive prizes denominated in Toncoin, the native cryptocurrency of TON blockchain, which is also used as a resource for contract execution.

Each task can bring you a max of 6 points. You get 5 points for solving a task. You get an extra point if you solve it without using any gas.

Minimum amount of points to be eligible for the prize is 6 points.

Prizes:

The top 15% of participants share $10,000 in TON
The middle 30% of participants share $10,000 in TON
The bottom 55% of participants share $10,000 in TON

Each prize pool is shared equally among the participants in that group. In total, we're giving away $30,000 in TON prizes.

The total prize might change depending on the number of participants.

🚀 Getting Started with TON

New to blockchain or TON development? Start here:

📘 Essential Tact Resources

Master the Tact language with these must-have materials:

Find ready-to-use smart contract examples here. Explore more about Tact in the awesome-tact repository.

🛠️ Tools for Tact Compilation and Testing

For Tact Challenge

For Tact Challenge we recommend cloning current repository and follow the submission guide described above.

To quickstart your own Tact projects

We recommend using tact-template for a smooth Tact development experience:

Clone the template repo
yarn build to build contracts
yarn test to test contracts
yarn deploy to deploy contracts

🌍 TON Developers Community Chats

Stay in the loop and engage with other developers:

nulla2011/bluearchive-logo

2023-10-16T01:37:26Z

Build modern full-stack applications on AWS

SST makes it easy to build modern full-stack applications on AWS. Watch the SST in 100 seconds video to learn more.

$ npx create-sst@latest

Pick your frontend

Deploy Next.js, Svelte, Remix, Astro, Solid, or any static site to AWS.

Add any feature

SST gives you the full power of AWS. Making it easy to add any feature to your product.

File uploads — Allow your users to upload files to S3.
Auth — Authenticate your users through any auth provider.
Events — Run tasks after your app has returned to your user.
Databases — Use a serverless SQL or NoSQL database to power your app.
Jobs — Run cron jobs or long running jobs powered by serverless functions.
APIs — Add a dedicated serverless REST, GraphQL, or WebSocket API to your app.

Collaborate with your team

Finally, you can git push to deploy using Seed, a service built by the team behind SST. And you can work on your apps together with your team with automatic preview environments.

Join our community Discord | YouTube | Twitter | Contribute

yesmore/inke

2023-10-16T01:37:26Z

📖 A markdown-like web editor with AI-powered, store data locally.

Inke - Small is beautiful

About Inke

Inke is a Notion-style WYSIWYG editor with AI-powered autocompletions.

Features

😗 WYSIWYG Editing like markdown
😄 Efficient Shortcut Inputs
😍 AI-powered Text Autocomplete
🥰 Local Data Storage
🥳 Image uploads(use command or drag)
😍 Cloud storage notes
😄 Export as json/image/txt
🥰 Install as PWA App to your desktop

Self Hosting

You can deploy your own version of Inke to Vercel with one click:

Setting Up Locally

To set up Inke locally, you'll need to clone the repository and set up the following environment variables:

OPENAI_API_KEY – your OpenAI API key (you can get one here)
BLOB_READ_WRITE_TOKEN – your Vercel Blob read/write token (currently still in beta, but feel free to sign up on this form for access)

If you've deployed this to Vercel, you can also use vc env pull to pull the environment variables from your Vercel project.

To run the app locally, you can run the following commands:

pnpm i
pnpm build
pnpm dev

Environment Variable

Prop	Type	Description	Example
`OPENAI_API_KEY`	`string`	The API Key to use for the OpenAI completion API.	`sk-xxx`
`BLOB_READ_WRITE_TOKEN`	`string`	OPTIONAL: Vercel Blob (for uploading images). Get your Vercel Blob credentials here	`vercel_blob_xxxx`
`KV_REST_API_URL`	`string`	OPTIONAL: Vercel KV (for ratelimiting). Get your Vercel KV credentials here	`"https//xxx.com"`
`KV_REST_API_TOKEN`	`string`	OPTIONAL: Vercel KV (for ratelimiting). Get your Vercel KV credentials here.	`abcdefg`
`NEXTAUTH_SECRET`	`string`	Only for production – generate one here: generate-secret.	`fasgagahhjerherg`
`DATABASE_URL`	`string`	DATABASE url	`mongodb://xxxx`
`EMAIL_FROM`	`string`	Next Auth Provider: Email	`Inke <regist@inke.app>`
`EMAIL_SERVER`	`string`	Next Auth Provider: Email	`smtps://xxxx`
`GITHUB_ID`	`string`	Next Auth Provider: Github	`xadsafsa`
`GITHUB_SECRET`	`string`	Next Auth Provider: Github	`xadsafsa`

Sync repo

# Sync
git fetch upstream
git merge upstream/main
git push origin main

Tech Stack

Inke is built on the following stack:

Next.js – framework
Tiptap – text editor
OpenAI - AI completions
Vercel AI SDK – AI library
Vercel – deployments
TailwindCSS – styles

Star History

License

iam-veeramalla/python-for-devops

2023-10-16T01:24:17Z

💥 A collection of all documents leaked by former NSA contractor and whistleblower Edward Snowden.

ghoshsuman845/List-of-Top-Unicorn-Startups-India

2023-10-16T01:24:17Z

This is an exhaustive list of Top Unicorn Startups in India.

cipher387/API-s-for-OSINT

2023-10-16T01:24:17Z

Collection of patterns, examples and resources for GitOps process design, GitOps repository structures, etc

apertus-open-source-cinema/axiom-firmware

2023-10-16T01:37:45Z

AXIOM firmware (linux image, gateware and software tools)

PXLAIRobotics/PXL_ML_Docker_v2.0

2023-10-17T01:41:25Z

daidr/douLog

2023-10-16T01:37:55Z

戴兜的博客（施工中）

viarotel-org/escrcpy

2023-10-16T01:37:55Z

📱 使用图形化的 Scrcpy 显示和控制您的 Android 设备，由 Electron 驱动

plantree/ocr-pwa

2023-10-16T01:37:55Z

A simple PWA for OCR, based on Tesseract.

PacificBiosciences/HiFi-human-WGS-WDL

2023-10-16T01:37:57Z

Yaazarai/2DGI

2023-10-16T01:38:24Z

2D Global Illumination GLSL ES

nsacyber/Mitigating-Web-Shells

2023-10-17T01:42:06Z

Guidance for mitigation web shells. #nsacyber

allyourcodebase/zlib

2023-10-17T01:42:13Z

https://www.zlib.net/